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Chapter 1 
Preliminaries 


This work is meant to be a guide to the use and operation of the Helicopter 
Antenna Radiation Prediction code (HARP). It is designed to accomplish 
the following objectives: 

• Serve as a quick reference to the operations of HARP. 

• Provide clear instruction on how to use HARP. 

• Give the user background information about the ordering of certain 
tasks. 

• Provide a list of the executable images that are tied to each of the 
HARP menu options. 

• Provide a list of the files HARP creates for data as well as error pro- 
cessing. 


1.1 What is HARP? 

HARP is a front end as well as a back end for the “Aircraft Modeling Code” 
(AMC) [1] and the “Airborne Antenna Radiation Pattern Code ” (NEWAIR) 
[2] computer codes. These codes use the Method of Moments (MM) and the 
Uniform Geometrical Theory of Diffraction (UTD) methods, respectively, to 
calculate radiation patterns for antennas on aircraft constructed from per- 
fectly conducting surfaces. In brief, AMC is a low frequency code which is 


HARP User’s Guide 


1 



CHAPTER 1. PRELIMINARIES 


most applicable when the body is not too large electrically. Running AMC 
for bodies which are more than several wavelengths in extent will result in 
excessively large computer memory and CPU time. AMC models an aircraft 
by a combination of thin wires (for the antenna and rotor blades) and polyg- 
onal plates (for the fuselage and wings/fins). NEWAIR is a high frequency 
code which is most applicable when the body is electrically large. Running 
NEWAIR on bodies smaller than a few wavelengths in extent will result in 
significant errors. NEWAIR models the aircraft fuselage by a composite el- 
lipsoid near the antenna attachment point and employs flat plates for the 
remainder of the fuselage and for the wings and fins. Note that the two 
codes are complementary with respect to frequency. The operation of these 
codes will not be further discussed here except as these operations relate 
to HARP. The native operation of these codes and their theories of opera- 
tion are discussed in separate user manuals available from the Ohio State 
University ElectroScience Laboratory [1,2]. 

The major difficulty in using these codes is in the creation of proper input 
files for particular aircraft and in the verification that these input files are, in 
fact, what was intended. HARP creates the AMC and NEWAIR input files in 
a consistent manner and allows the user to verify them for correctness using 
2D and 3D graphics. HARP can then display the calculated field patterns 
on the screen or provide hardcopy output. Because the process of obtaining 
field plots has been so automated by HARP, user productivity can be many 
times what it is when the input files must be created by hand. Great effort 
has been made to take what was once a difficult, time consuming, or even 
impossible task, and turn it into one that is easy, quick, and consistent. This 
is the major contribution of HARP. 


1.2 Assumptions About the Equipment 

• A Tektronix XD88/30 or XD88/35 Workstation running the UTek V 
Release 3.2c operating system (UNIX). 

• A Tektronix 4957 digitizing tablet or equivalent. 

• A Tektronix eight control, LCD dial box. 


HARP User’s Guide 


2 



CHAPTER 1. PRELIMINARIES 


1.3 Assumptions About the User’s Experi- 
ence 

It is also necessary that the user have the following minimal knowledge so 
that proper and useful results can be expected: 

• A user knowledge of the Tektronix XD88 Workstation running the 
UTek V Release 3.2c operating system (UNIX). 

• An understanding of the relative limitations and strengths of the Method 
of Moments and Uniform Theory of Diffraction approaches to solving 
electromagnetic radiation problems. 


1.4 How This Guide is Organized 

There are two main parts to this guide: 

Part 1 contains a quick overview of all HARP operations possible from the 
menu system. 

Part 2 contains support information about each of the HARP operations in 
more detail with emphasis on what is happening and how each opera- 
tion works with the others. Complete examples of HARP in action are 
also provided in this part. 

1.5 How to Use This Guide 

1. Use Part 1 to begin. Each menu item is tied to an operation. These 
operations can be invoked even if the user is not sure exactly what will 
happen. If HARP is unable to carry out an operation, the user will be 
provided a brief message stating the problem or providing a suggestion 
for further action. 

2. Use Part 2 to learn more about what is actually happening when a 
HARP operation is executed. How each of the operations is tied to the 
others is also described in detail. 

3. As more experience is gained, use this guide for reference. 
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1.6 Notational Conventions Used 


In this guide the main menus will be denoted in square brackets. Thus, the 
fourth menu would be referred to as Menu [4]. Each of the options within 
a menu will be referred to using two numbers. The first number denotes 
the menu in which the option is located. This number is then followed 
by an underscore and, finally, the option number for that particular item. 
Thus, the fifth option in Menu [4] would be called Option 4_5. HARP is 
not case sensitive to user input that requires a “yes/no” response. Another 
convention used here is that computer output to the screen will be preceded 
>y t: Possible user’s responses to these questions will be boxed like this: 


italics 
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1.7 HARP Menu Structure 


HARP Main Menu 


Option 1 >>> 
Option 2 >>> 
Option 3 >>> 
Option 4 >>> 
Option 5 >>> 
Option 6 >>> 
Option E >>> 


Generate Body Geometry 
Change Working Directory 
Utility Functions 
Generate/Display Model(s) 
Calculate Radiated Fields 
Display Calculated Results 
Exit HARP 


[1] Geometry Entry Menu 

Option 1 >>> Enter Body Cross-sections 
Option 2 >>> Build/Modify Master File 
Option 3 >>> View Default Body Silhouette 
Option 4 >>> Interpolate Cross-section 


[3] Utilities Menu 

Option 1 >>> Inquire/Set Family Name 
Option 2 >>> Set User Preferred Units 
Option 3 >>> Exit HARP to your Shell 
Option 4 >>> Submit Bug Report 
Option 5 >>> Predict MM Completion 
Option 6 >>> Archive/ Restore Data 
Option 7 >>> Write Status File to Disk 
Option 8 >>> Set Temporary AMC Defaults 

[4] Model Comparison Menu 

Option 1 >>> Add/Display Physical Features 
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Option 2 >>> Generate/Display MM Input Model 
Option 3 >>> Calculate UTD Ellipsoid 
Option 4 >>> Calculate UTD Plates 
Option 5 >>> Display UTD Body 
Option 6 »> Enter Towelbar Antenna 

[5] Field Calculation Menu 

Option 1 >>> Build/Show MM Graphics 
Option 2 >>> Do MM Calculation 
Option 3 >>> Do UTD Calculation 

[6] Field Display Menu 

Option 1 >>> In-situ Plot MM Results 
Option 2 >>> In-Situ Plot UTD Results 
Option 3 >>> Hardcopy MM Results 
Option 4 >>> Hardcopy UTD Results 

All operations possible with the HARP system are accessed through these 
menus. 
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HARP: Quick Overview 


HARP User’s Guide 


Chapter 2 

Getting Started 


To run HARP the user must be logged into a Tektronix XD88 on the main 
display terminal. In addition, the HARP executable images must be in the 
user’s directory path and the user must have execute access to these files. 
Before starting a new project it may also be useful to create a new directory 
for the files that HARP will create. In any case, the user must have the 
proper read and write access to the directory where the HARP work is to 
take place. 

Before starting HARP the user must be in a Tek Peer or Tek ^Vindow, 
or Tek Screen. This is accomplished by typing one of the following: 

1. tekscreen 

2. tekinit 

The first of these choices utilizes the entire screen. The second choice 
opens a smaller TekGraphics window in the middle of the screen. This second 
option allows ready access to the user’s standard environment so that other 
work may continue while HARP is being run. 

Once the appropriate graphics window has been opened, HARP can be 
started by typing the following at the prompt: 

$ harp 

At this point HARP will do some initializations and display the main menu 
selections. In this mode HARP is capable of many 2D and 3D graphics oper- 
ations based on STI, the Tektronix graphics system. Many of the HARP op- 
erations must use this graphics capability. However, once the aircraft models 
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have been created, most HARP operations, including all the electromagnetic 
calculations, can be done without this graphics capability. For users logged 
into the workstation from an Xterminal, a vt-type terminal, or another ma- 
chine with an xterm or other vt-terminal emulator, a non-graphics option is 
provided so that HARP can run with almost all the functionality enjoyed by 
users logged into the main display system. For this option the user would 
type the following at the prompt: 

$ harp -ng 

In this case the user would be presented with identical menus and options 
as before except those menu items not possible due to graphics limitations 
would be *’d out and not accessible. This option brings the functionality of 
HARP to many more users than would otherwise be possible. 


From the HARP Main Menu there are six options that can be selected: 


Option 

Option 

Option 

Option 

Option 

Option 

Option 


1 >>> Generate Body Geometry 

2 >>> Change Working Directory 

3 >>> Utility Functions 

4 >>> Generate/Display Model(s) 

5 >>> Calculate Radiated Fields 

6 >>> Display Calculated Results 
E >>> Exit HARP 


All of these options, except for Options 2 and E, place the user in a second 
level menu where various options are logically grouped together to accomplish 
related tasks. All operations possible with HARP are accessed through this 
main menu. Therefore, each option in this main menu represents a second 
level menu except for Option 2 and Option E. Most of the HARP operations 
must take place in a specific order for correct results to be achieved. Great 
effort has been made so that if an illogical or incorrectly ordered operation 
is attempted, the user will be notified that this has occurred with an ap- 
propriate message and/or option to continue. There are twelve acceptable 
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inputs cause the bell to sound. The user is then returned to this HARP 
Main Menu. Note that HARP is not case sensitive to inputs for menu 
selection or “yes/no” responses to questions. 

2.1 [l] Generate Body Geometry 

When entering a new geometry, this is usually the first submenu the HARP 
user will see. Selecting this option places the user in Menu [1]. From this 
menu the user can enter cross-sections of a particular aircraft into a HARP 
database by digitizing points that make up the cross-sections from a blueprint 
or other drawing using the Tektronix 4957 tablet . This action is initiated 
by choosing Option 1_1. 

From this submenu the user also builds or modifies the master file for a 
given body by selecting Option 1_2. The master file is basically a file that 
contains a list of cross-sections files that make up the body of a given aircraft. 
This master file contains the list of files which contain the data used to loft 
the 3D body for both display purposes and the electromagnetic calculations. 
The HARP code takes the cross-section data in the files listed in the master 
file and interpolates or lofts between these cross-sections in a special way to 
build the 3D model of the aircraft fuselage. The master file must be built by 
exercising Option 1_2 before any graphics or field calculations can be made. 

The third option in the first menu, 1_3, allows the user to see the top 
and side silhouette of the current default body after the master file has been 
made. The RED markers in the display represent the maximum extent in the 
data points in each active cross-section file for the particular silhouette view 
displayed. The GREEN lines connecting these points are linear segments 
between these points, i.e. they do not represent lofted data. This option 
allows the user to quickly see where each of the cross-sections is located. It 
also allows the user to determine where additional cross-sections should be 
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located. The aspect ratio of the displayed body is one to one with the actual 
data so the display shows a properly scaled silhouette. This 2D display acts 
as a quick visual check on the body geometry so that the user can correct 
any obvious problems before proceeding to more complex HARP operations. 

Option 1_4 allows the user to create a new cross-section file from any two 
pre-existing cross-section files by making a linear interpolation between them 
at the position the user specifies along the axis of the aircraft. Extrapola- 
tions are also possible if the user specifies a position that is not between the 
specified cross-sections. This feature is useful for creating a blend between 
cross-sections from different aircraft so that hybrid models can be made. It 
can also be used to create cross-sections along a tapered part of an aircraft 
model. 


2.2 [ 2 ] Change Working Directory 

This Main Menu option immediately displays the present working directory 
and asks the user to specify a new directory. The new directory can be 
specified relative to the present one or an absolute directory specification can 
be entered. HARP will then display the new default directory and return to 
Menu [1]. With this option HARP can be started in any directory and the 
user can quickly change to another desired project directory without having 
to exit and restart HARP in the new directory. It should be noted, however, 
that HARP must have read and write access to many files. Therefore, the user 
must have the proper access to the current directory for HARP to function 
correctly. 


2.3 [ 3 ] Utility Functions 

Selecting this option places the user in Menu [3], the Utilities Menu. Here, 
six basic options are provided. Option 3_1 provides one way for the user 
to find out what the current family name is or to set a new one. HARP 
creates a great number of files for a given aircraft. While it is possible to 
work on a number of aircraft in the same directory , it is not recommended. 
Because all the files associated with a single aircraft have the same family 
name in common, HARP is able to automatically pick up the correct files 
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for a given aircraft even if more than one aircraft is being worked on in the 
same directory. 

Distances digitized on the tablet or absolute distances the user may be 
asked to enter such as an antenna length can be given in meters, centimeters, 
feet, or inches. The default unit for distance can be set with Option 3_2. 
After the preferred units are set, whenever HARP needs a distance, it will 
automatically ask the user to enter those numbers in these default units. The 
default unit for distance can be changed at any time, even in the middle of 
building an aircraft body. 

Option 3_3 allows the user to temporarily exit HARP to the default UNIX 
shell. This is useful when HARP has been started in a Tekscreen where there 


is no acces s to other windows. To return to HARP when finished, simply 
enter | exit followed by return . 

If Option 3_4 is invoked the user may enter a brief message describing a 
problem with HARP believed to be a bug. This message will automatically 
be sent to the harp-maintainer at The Ohio State University ElectroScience 
Lab via email. 


Option 3_5 provides the user with an estimate of when electromagnetic 
field calculations done by the Method of Moments (MM) will be completed. 
This functionality is provided because these calculations can take minutes, 
hours, or even days to complete. Due to computer resource limitations, only 
one MM problem can be run at a time. By using this option the user can 
see how long a given run will take, and have an idea when the next job can 
be started. 


With Option 3_6 the user has the ability to store all the files in a given 
directory with a specified family name in a single compressed file with a user- 
specified tag. At some later time the user can then restore all the files that 
went into this compressed file to their original form. When many changes 
are being made to the HARP database or when work has been completed on 
a given model, this option provides a “snapshot” capability so that the user 
can go back at any time to restore the complete “state” HARP was in at the 
time this option was exercised. 

Option 3_7 is designed to remind the user of the status of the files with 
the current family name. The summary can either be written to a disk file 
or echoed to the user’s screen. Unlike Option 3_6, this Option only saves the 
summary of the data in the family name files, not the files themselves. 

Option 3_8 is used to set temporary defaults for the MM code that will 
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modify its printing and/or integration accuracy. Because the standard de- 
faults are well suited for most jobs, it is anticipated that this Option will be 
rarely used. 

2.4 [ 4 ] Generate/Display Model(s) 

This option places the user in one of the most used HARP menus, Menu 
[4], From here all physical, moment method, and UTD models are generated 
and displayed so that the user may visually verify their correctness. It is 
also in this menu that the input files for the AMC and NEWAIR codes are 
automatically created. It should be noted that before any of the options in 
this menu can be exercised, the master file must have been created by the 
appropriate actions in Option 1_2. 

Option 4_1 allows the user to display the physical features of the model 
of the aircraft or to add or modify features such as fins, antenna location, 
or, for helicopters, the geometry of the rotor blades. Fin here is a general 
term to describe wings, horizontal and vertical stabilizers, and other aircraft 
control surfaces. For each of these three items, fins, antenna location, and 
rotor blades, the user is confronted with a sub-menu where there are three 
choices: 

1. Use a data file for the item that already exists. 

2. Enter new data for the item through direct entry or the tablet. 

3. Forget about the item for now. 

As usual, if an option is selected that does not make sense, such as wanting 
to use a fin file that does not exist, HARP will give a message and return 
the user to the appropriate sub-menu. 

For relatively low frequency work (body less than several wavelengths 
in extent), the Moment Method model (MM) can be created and displayed 
by selecting Option 4_2. The wire and polygonal plate model displayed is 
that which is input to the AMC code. This option also creates the input file 
containing geometry and other instructions for the AMC code. 

For high frequency work (body more than several wavelengths in extent), 
the moment method (MM) cannot be used to calculate the field patterns. 
The matrix equations that would need to be solved become far to large to 
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be solved on an XD88. Therefore, at higher frequencies, the NEWAIR code 
based on the Uniform Theory of Diffraction (UTD) is used. The NEWAIR 
code calculates the field patterns by computing the radiation from a com- 
posite ellipsoid that approximates the surface of the aircraft in the vicinity 
of the antenna and a set of flat plates that model the rest of the aircraft. 
Note that the composite ellipsoid is formed by joining two ellipsoids at the 
antenna location in such a way that the vectors tangent to the surface are 
continuous across the junction. After the antenna location has been selected 
using Option 4_1, this composite ellipsoid is calculated by selecting Option 
4_3. Before any other UTD operations can be performed, this step must have 
been successfully completed. In many cases, especially with helicopters, the 
composite ellipsoid is not sufficient to model the fuselage of aircraft. To rem- 
edy this defficiency, flat plates can be generated with Option 4_4, which are 
added to the composite ellipsoid to improve the high frequency model of the 
fuselage. It is very important to emphasize at this point that Option 4_4 
should not be confused with Option 4_1 where fins, wings, rotor blades, etc. 
are also modelled by flat plates. In other words, Option 4_4 generates plates 
to improve the high frequency model of only the fuselage. 

Before calculating the field patterns with the UTD code, the aircraft body, 
the ellipsoid, and any plates created by Option 4_4 can be visually inspected 
for correctness with Option 4_5. This option will then display the body in a 
pseudo-translucent manner with the composite ellipsoid calculated in Option 
4_3 superimposed over the body in its proper position and the plates created 
by Option 4_4. At the present time, the plates generated by Option 4_1 can 
not be used in the NEWAIR code; however, work is in progress to add that 
capability to the HARP code. 

Option 4_6 provides the user with a graphical method of entering a “tow- 
elbar” antenna that can be used with the MM code. 

2.5 [ 5 ] Calculate Radiated Fields 

Having selected the method for calculating the field patterns and completed 
the appropriate operations in Menu [4], the user can now calculate the field 
patterns. There are three options in Menu [5]. The first two have to do with 
the MM and the third, UTD. Option 5_1 takes the geometry file created 
by Option 4_2 and computes and displays the geometry used internally by 
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AMC. It makes no electromagnetic calculations, but processes the input file 
generated by Option 4_2. This option takes very little computer time, and 
should virtually always be used to verify the geometry before committing to 
a full MM run with Option 5_2. 

Option 5_2 is used to make the complete MM calculation of the field pa - 
terns. Because this option can take several hours to complete, it is starte 
as a background job and the menu immediately returns to its normal state, 
ready for more user input. This does not mean that the field pattern calcu- 
lation has been completed. As of this writing, there is no return signal to 
HARP when the job has been completed. How the user can tell when the 
field calculations have been completed will be discussed in Section 4.5. 

Option 5 3 is used to make the UTD field calculations. Unlike Option 
5 2, the job is not launched in the background, since it typically takes far 
less computer time to complete than the MM calculations. 

2.6 [ 6 ] Display Calculated Results 

There are two options for viewing the results of the field calculations on the 
screen and two options for hardcopy output. To view the results in 3D on 
the screen, Option 6_1 is used to see the MM results and Option 6 2 is used 
to view the UTD results. If any attempt is made to view the results of the 
field calculations before they are completed, HARP will issue a warning an 
return to this menu. Similarly, for hard copy output Option 6_3 is for the 
MM results and Option 6_4 is for the UTD results. 


2.7 [E] Exit HARP 

Entering an [1] or [el followed by hitting 1 return] from any menu will exit 
that menu. From the HARP Main Menu, HARP, itself, will be exited. 
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Part II 

HARP: In Depth 
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Chapter 3 

[1] Geometry Entry Menu 


In order for HARP to calculate a radiation pattern for a particular aircraft, 
all relevant data needed for the calculation must first have been entered into 
a HARP database. For accurate results, perhaps the single most important 
operation is the accurate entering of the 2D cross-sections used to create 
the 3D model of the fuselage of the aircraft to be studied. From this menu, 
aircraft fuselage cross-sections along the length of the aircraft are entered, 
and master files which contain lists of these cross-sections and where they 
are to be used in the model are made. Following the creation of these master 
files the 2D silhouettes of the models can be viewed and 3D models can be 
created and viewed from other menus. 


3.1 11 Enter Body Cross-sections 

HARP builds the 3D physical model of an aircraft fuselage by lofting be- 
tween representative cross-sections along the length of its body. These cross- 
sections must be entered by the user either from a blueprint or other engi- 
neering drawing using the Tektronix 4957 digitizing tablet. The coordinate 
system used by HARP and several of the cross-sections used in the example 
in Chapter 8 are shown in Figure 3.1. Note that the aircraft is essentially 
flying in the the -y direction with its nose near the origin and its fuselage 
extending out the +y axis. The xy plane is the horizontal or azimuth plane 
and the z axis points toward the top of the aircraft. 

When Option 1_1 is first invoked, if the current family name and pre- 
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Figure 3.1: This is the coordinate system used by HARP. Several example 
cross-sections are shown. Note that the nose of the aircraft points toward 
the origin of this coordinate system and that the body lies along the y-axis. 
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ferred user units have not yet been specified, the user will be asked to supply 
this information before going on. See Sections 4.1 and 4.2 for a complete 
description on ways to specify these units. 

The first step in creating an aircraft model with the HARP system in- 
volves the selection and entering of representative cross-sections of the fuse- 
lage of the aircraft to be modeled. These cross-sections should be selected in 
such a way that there are more cross-sections entered in areas of the aircraft 
body where there are the greatest changes in its geometry and relatively 
fewer in areas where there is little change in its geometry. By selecting cross- 
sections in this way the model that is generated from these cross-sections will 
most closely conform to the geometry of the actual aircraft. The process of 
entering these cross-sections begins by invoking Option 1_1 where the follow- 
ing questions and requests for action are made: 


► Now enter the model description line. Some user string 


At this point, type a line describing the location of the cross-section to serve 
as a reminder where on the aircraft body it is located or some other rele- 
vant information. This feature is solely for the convenience of the us er and is 


not used internally by HARP. If no description is desired, simply hit return 


> Enter the cross-section file number (extension) . . . | 10 


In response to this request the user should enter a number like 10 j (which 
uniquely describes the cross-section to be entered) and hit return | . Every 
cross-section file has a family name like “lh” and an extension number from 
000 through 999. Thus, there is a limit of one thousand active cross-section 
files for any aircraft. While there can be up to a thousand cross-section files, 
all these files need not be active at one time to make up the aircraft model. 
See Section 3.2. In practice fifteen to twenty cross-sections may be enough for 
an accurate model. Cross-section file extensions usually start at 0 or 1 and 
increase for those farther out on the y-axis along the aircraft body. This is 
not a requirement, however. These extension numbers may be in any desired 
order or no order at all. Similarly, there is no restriction on the order that the 
cross-section files need to be entered. The user may find it useful, however, 
when entering cross-sections, to leave a few unused extension numbers be- 
tween adjacent cross-sections so that new cross-sections can be conveniently 
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added later between the old ones. The sole advantage of this is that files 
with higher extension numbers will always be farther out toward the tail of 
the aircraft. In practice, this is less confusing to the user, but it makes no 
difference whatsoever to HARP. When specifying extension numbers it is not 
necessary to enter any leading zeros. 


►Enter the y-station location for cross-section 102 in meters: 


S.459 


In this case, 102 is the current extension nu mber. E nter the y coordinate 
where the new cross-section is located and hit | return | . Remember that each 
cross-section lies completely in an xz-plane so to specify the (x,y,z) coordi- 
nates of the points that make up the cross-sections in 3D, the y-axis coordi- 
nate must be specified. Figure 3.1 shows the HARP coordinate system and 
representative cross-sections. If the preferred units are other than meters, 
HARP will ask for the y coordinate to be input in those units instead of 
meters. See the section on Option 4_2 for a complete description of preferred 
units. 


=>■18 this a symmetric cross-section [Y] ? [ return 

If the aircraft to be modeled is identical on the port and starboard sides 
(symmetric about the yz plane) at the location for which a cross-section is to 
be entered, this symmetry can be exploited. In this case the user can enter 
the half cross-section x > 0 and it will be mirrored to the other half-plane 
to complete the entire cross-section. If the two sides of the aircraft are not 
identical at the location of interest, the user should type 
case the user must enter the entire cross-section. 

=> Enter two points to use as a known distance on the tablet. 

At this point the user would position the drawing or blueprint of the cross- 
section of interest on the Tektronix 4957 tablet and secure it with masking 
tape. Next, two points on the drawing that are a known distance apart would 
be selected and entered by depressing the YELLOW button on the digitizing 
puck when the crosshairs were aligned over these points. This sets the scale 
of the drawing so that distances entered on the tablet are automatically en- 
tered into the HARP database files with the proper magnitude. Choosing 


n return . In this 
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the maximum extents of a cross-section alone the z-axis is often a convenient 
choice for these points. 


►Enter this distance in meters: 


10.25 


The distance requested here is the known full scale distance between the two 
points just entered on the tablet. If the preferred units are centimeters, feet, 
or inches, this distance will be requested in those units instead of meters. 
Note that this distance is the scaled distance in drawing units, and not the 
tablet distance between these points. For example, if the distance between 
the s electe d points is 1.3 m eters on the full size aircraft, then the user would 
enter 1 1.3 | and hit return . An example cross-section is shown in Figure 3.2. 


► Enter the cross-section origin on the tablet. 


For the typical cross-section shown in Figure 3.2, the origin would entered by 
positioning the crosshairs of the puck over the origin location and depressing 
the YELLOW button on the puck. In Figure 3.2 this is the point marked 
Cross-section Origin. This point must be consistently chosen because all the 
cross-sections that make up the body must share this common point in the 
xz-plane. In other words if all the cross-sections were placed on the same 
xz-plane, they would share the same coordinate system and origin. The co- 
ordinate origin may be internal or external to a given cross section. 


Enter any reference point on the positive (up) z-axis. 

In Figure 3.2 this is the point marked Up Vector Point. This point is entered 
by lining up the puck and depressing the YELLOW button. These actions 
specify the coordinate axes on the tablet. This information, coupled with the 
known distance entered previously between the two reference points, provides 
all the information necessary to build the transformation matrix that is used 
to convert the tablet coordinates created when the YELLOW button on the 
puck is depressed to the real world coordinates used by HARP. 


=£■ Enter the half cross-section now, starting on the + z-axis, 
=$■ Progressing clock- wise, stopping on the - z-axis, 

=^-enter 6 to 50 POINTS. Use BLUE to enter the last point. 
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Z i 



Figure 3.2: This is a typical cross-section showing the origin, up vector point, 
and possible points that could be digitized. 
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=>( Use GREEN to delete previously entered points. ) 

The complete cross-section can now be entered by digitizing the points in 
the right xz-half-plane as shown in Figure 3.2. Points are entered by push- 
ing the YELLOW button on the digitizing puck. Refer to Figure 3.2 again. 
The user would start with the point on the z-axis just below the Up Vector 
Point and proceed clockwise around the cross-section, ending on the z-axis 
by depressing the BLUE button for the last point. Cross-section points are 
always entered in this way. The first point digitized must always be highest 
point on the z-axis. Points must then be entered in a consecutive, clock- 
wise fashion until the last point is reached, again, on the z-axis. The last 
point must always be located on the z-axis, and it must always be entered 
with the BLUE button on the puck. The above constraints are required only 
for cross-sections specified as being symmetric. For non-symmetric cross sec- 
tions, one need not start and end on the z-axis. Depressing the BLUE button 
signals HARP that the last point to be digitized has been entered. No more 
that fifty points can be entered in total for a symmetric cross-section, and 
no more that one hundred points can be entered for a non-symmetric one. 
After the last point is entered, all the points are then splined in a special way 
and reflected to the negative half-plane so the complete cross-section can be 
displayed. If an error has been made entering a point, immediately pushing 
the GREEN button will delete this point. Repeatedly pushing the GREEN 
button will delete entered points back through the list in the reverse order 
that they were entered. After the cross- section is displayed it is not possible 
to correct a cross-section if it is not accurate. In this case, simply enter a 
new cross-section. When asked for the extension number, enter the same 
extension number as that of the file that must be redone. The old file will 
be overwritten. 


►Do you wish to enter another cross-section [Y] 1 ft Tttuvu 


To create a new cross-section simply hit 1 return | which is the default response 
or type a \y\ or \y] then hit [return) . Any other response will be interpreted 
as a no and the code will exit this option. 
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3.2 1_2 Build / Modify Master File 

After at least two cross-sections have been entered, and before the aircraft 
body can be viewed, the master file must be created. This file contains the 
total number of active cross-sections, their y coordinate locations, and a list 
of the files that contain the cross-section data. It is this master file that 
provides HARP with the list of cross-section files to read and where to use 
this data in building the model of the fuselage of the aircraft. There are 
eight possible operations accessible from Option 1_2 concerning the making 
or modification of the master file and the cross-section files. 

The eight operations are all listed when Option 1_2 is first invoked and 
whenever any of these operations has been completed. Each can be invoked 
in any desired order, but the user must be aware of the interactions among 
these operations so that the desired results are obtained. Unless expert mode 
(see Section 4.1) is active, all operations are automatically performed using 
the current fami ly name Each option is selected by entering its first letter 
and then hitting [ return . Invoking Option 1_2 lists these choices: 

^1-ist, b-uild, c-opy, y-location, i-nfo, n-ame, d-elete, r-edraw, e-xit: 

=> Enter your choice now [L-istj: | return 

I-ist: The default operation is l-ist. It looks up the current family name 
and finds all the cross-section files which exist in the present working direc- 
tory with that family name. It then reports how many cross-section files 
were found and lists on the screen the files found along with their informa- 
tion fields and y-locations. No files are written and this operation does not 
interact with any other operation. It is informational only. The ★ at the 
far left of some cross-section file names in di cates that the *’d file is included 
in the current master file. Hitting return or / return invokes this operation. 

b-uild: The b-uild operation actually creates the master file for the current 
family name. It first lists the number of cross-section files and then asks if 
any of these files should be excluded from the master file. If it is desired to 
exclude any files, simply respond with a [Y| or [y] and provide the appro- 
priate file’s extension number. HARP will then ask if there are any other 
files to be excluded. If there are no more files to exclude, hit \ return] to 
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automatically accept the “N” response. Note that excluding cross-section 
files from the master file does not delete any files. Excluded files are just not 
used to form the model of the fuselage of the aircraft. Also note that each 
time a new master file is built, all available cross-sections are automatically 
included. In other words, previously excluded files are re-included and must 


again be excluded if that is the desired operation. Typing \b return invokes 
this operation. — 


c-opy: The c-opy operation allows the creation of new cross-section files, 
which are identical to previously entered ones, except that they are at a 
new y coordinate value along the aircraft body. With many aircraft there 
are long stretches along the fuselage that share the same cross-section shape. 
The user can employ Option 11 to reenter the same cross-section at different 
y values any number of times, but using the c-opy operation is the preferred 
method for creating these additional cross-sections. This method is quicker 
and m ore accu rate, and tends to result in better models. Typing [cl and 
hitting | return | yields the following dialog for copying the cross-section file 
with extension 23 to a new file with extension 25: 


>What is the extension number of the cross-section file 


►that you want to copy? [none]: [ 23 


What is the extension number of the new cross-section 


►file that you want to create? [none]: [25 


► The current preferred distance unit: meters 
►The original y value : 4.561 

► Enter new y value : 5.S5S 


Note that this option does not move the cross-section from y = 4.561 meters 
to y = 5.353 meters, but rather creates a new cross-section at y = 5.353 
meters. 


y-location: If the y location of any of the cross-sections was entered incor- 
rectly, this value can be changed by invoking y-location. The file extension 
number is requested and then the old y value is displayed in the user's pre- 
ferred units along with a request for the new value in those same units. If no 
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change is desired, simply hit [ return | . Typing [yj and hitting | return] would 
yield the following dialog to change the y value in the new cross-section file 
just created with c-opy: 


>What is the extension number of the cross-section file 
>-that you want to change [none]? 1 25\ 

► Old v-location in meters: 5.353 

J i : t. 


— =»New y-location in meters: 5.777 


Note that this operation only updates the cross-section file. It does not auto- 
matically update the master file. Warning! For changes made by y-location 
to be incorporated into the model, the cross-section file must be active and 
the b-uild operation must be re-run to update the master file. 


i-nfo: The information string included in each cross-section file can be edited 
using the i-nfo option. This information is only used to as a convenience to 
the user to help identify the location of the c ross-sect ion. This string is 
limited to 30 characters. Typing 0 and hitting ] retard] would result in the 
following dialog to change the information field in cross-section file 25. 


►What is the extension number of the cross-section file 
►that you want to change [none]? 

► Old string: Copied from esl.023 


25 


New string: Some new description here 


Note that when a new cross-section file is created from a previously exist- 
ing one using c-opy , the information string automatically lists the original 
source file. Thus, if the file esl.025 were created from the file esl.023 , the 
information field of esl.025 would state that it was Copied from esl.023. 
The information string in any cross-section file can always be changed using 
i-nfo. Because this 30 character string is not used for any other purpose by 
the HARP system, the master file need not be updated. 


n-ame: HARP also allows the renaming of any files for which the user has 
proper write access. This can be done with the n-ame option. This option 
does not list any files and if the file specified does not exit, no action is taken. 
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The user is then returned to the build master menu. If the file does exist, 
u”« ^prompted for the new name. Before the file is actually renamed, 
the user is asked to confirm the change from ‘he old name to the new name. 
Typing 1 n return] would result in a dialog like the following. 


3 =^. File to rename [none]: some-old -fi le 


►New file name: | some^new^name 
.Rename some-old-file as some-new-name ? |y] | retur n 


By hitting [return] the file some-old-jile is renamed as some-new-name. 


d-elete* HARP allows the user to delete cross-section files by using the d- 
elefe opUon The user is asked for the extension number of the cross-sec : ron 
file to be deleted. If the file exists, the file is deleted wthout conformation 
If the file does not exist, no action is taken. Typing 0 and hitting \re nm ] 
would initiate a dialog like the following. 

=>What is the extension number ofjthe cross-section file 
=*that you want to delete [none]? [25] 

Tn this case the file csl.025 would be deleted assuming that “esl” was the 
family name The d-elete operation is not intended as a genera purpose 
waT to deWe unwanted files. The intended purpose is solely o provrded a 
mechanism to eliminate unwanted cross-section files 
HARP. The elimination of other unwanted files is best handl 

shell. 

r-edraw Any of the cross-section files that exist, regardless of whether they 
oaTof a master file or not, can be be redrawn on the screen m 2D with 
The splin’e curve that 

at the v location of the cross-section is shown in GREEN. The data poi 
[hat were entered on the tablet are shown in RED. The xs-ax.s for the cross- 
. i • dt tje The r-edraw is useful for reviewin g cross-s ection 

^es' when building the aircraft models. Typing 0 and hitting & would 
initiate a dialog like the following: 
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=>What is the extension number of the 
=>that you want to redraw [none]? [j?] 


cross-section file 


n this case the cross-section file esl.006 would be drawn on the screen This 

r f “rbr mng r the famiiy name *“ , '“ i ” “ d «« <h « 

m nofzr Pr ° gram WOUld •* " ilh a tt* the file 


OpttoTlT * “ kula ‘ ions ' T "“8 0 “ d hitting „ iU exil 


3.3 


1_3 View Default Body Silhouette 


tllll'A TIT 1 ” fi ‘n haS b ' e " CTeated ' ifal1 cross eeetions have not been 
ntered, the overall appearance of the aircraft fuselage can be quickly checked 

1 SnTeVn ‘ OP “ d >ida ,f houettes of the body by selecting Optn 

einl In e °h V ofTb are a * * **“ “““ thal the maximum 

RED Note tfat he gSnT^ *" * tatod “ d ”^ d » 
mote that the GREEN outline of the aircraft is composed of linear 

e segments between these points and not the splined curve HARP will use 

between the cross-sections in the 3D body. The silhouettes shown are in 

e correct scale of length to width so the overall appearance of the aircraft 

should match that of the actual aircraft being modeled. 


3.4 1_4 Interpolate Cross-section 

At times it may be desirable to create a new cross-section that is linearly 
interpolated or even extrapolated from two existing cross-section files This 
situation could occur when cross-section drawings were not readily available 

, ,? tTOm a blueptintl but W " e d '"ly interpolations or 

xtrapolations from other provided cross-section drawings. At other times it 
may be desirable to create a hybrid model of an aircr j, that is a 
ending of two or more other models. In this situation, a better transition 
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can be made by creating new interpolated cross-section files. A typical dialog 
the user would expect from invoking this Option follows. 

=>First cross-section file [none]: 

=*> Second cross-section file. 

= 4 > New cross-section file: Q77 

— ^Thp current preferred distance unit: meters 

=>lh.014 y value: 36.00000 
— > lh 01 5 y value: 50.00000 



>lh.077 y value: jLSS18^ 


=^File lh.077 has been created. 

• i If V value soecified does not lie between the two original cross- 
^tioTfhe new extrapolated cross-section should be checked with the r-edrav 
"option l_2 becanse this operation may generate a fuselage that 

contains loops. 
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[ 3 ] Utility Menu 


Options in the Defaults Menu allow the user to set a new family name or 
to check the present default family name. The user preferred units of length 

HlRP°r tendT th" T' 1 ®” deSiMble ‘° b ' aUe l ° ‘^forarily leave 

AR p to tend to other business without exiting the HARP system This 

is also possible from this menu. Other options in this menu allw the user 

archL m HA\p U lTmes. PrediCt C0mPl ' tiOn ^ MM -d 


4.1 3_1 Inquire/Set Family Name 

™Sv°b»rd 3 ‘5 “ rt d lhe CUrre, “ fami ' y name U ^yed, « has 

y een declared in the present working directory fpWY Tf th;. r-,milv 
name « the »e desired>np,y hit S To changed Jew ££ name" 

Xlr ® ,h HARP Wi “ tb “ “ k fo ' new family name 

After entering the new name the user must then decide if HARP ezvert or 

no„,ce mode should be set. This mode significantly affects the poX Id 

ffexibrbty of the HARP system. An infrequent, new, or casual usTLTk 

mod. Vh° g °? ” ilh a Si “ gle family nama ’ sbould «d«ct the novice 

moit This may speed up work by assuming the same family name for all 

the y, «?T’ 'c e CXpeH mode aUoW! tbe n** ‘o mix and match 
he various files from other family names to form composite models This 

“ , d d ' X ‘ blllty can be «tremely useful and time saving. In response 
the mode question, enter a £>] for novice mode or a Q] for expert mode 
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The novice mode is the default mode and can be selected by simply hitting 
, m : 3 9 is alsn automat- 


ice moae is me uciaun - - 

I return I. Any time a new family name is selected Option 3_2 is also automa - 
ically invoked to set the user’s preferred units for length. See Section 4.2 for 
details. Assuming that the family name “esl” has already been set in the pwd 
and that it is desired to change the family name to “fl8” and to then work 
with units of feet, the following dialog would result upon invoking Option 3_1. 

=*The current family name: esl Ok? [Y] [n] 


► Please enter the new default family name: \f!8 


=^The level of family file name confirmation used in HARP 
=*can now be set. The flexibility of the HARP system is 
=>■ affected by the level set. Please take note! 

=> Enter a 1 for Expert level with maximum confirmation 

— >OT a 0 for Novice level with minimum confirmation [0]: | return 


Default Units 



1 > You want to work in meters. 

2 > You want to work in centimeters. 

3 > You want to work in feet. 

4 > You want to work in inches. 


=>• Enter option... [1]: 0 

If no previous family name had been set, this dialog would have been the 
same starting with the request for the new default family name. 


4.2 3_2 Set User Preferred Units 

There are various times the user must specify distances when creating the 
HARP database files for an aircraft. The default unit for distance can be 
specified as meters, centimeters, feet, or inches. Option 3_2 is used to set 
these default units. After these units are set, HARP automatically reques s 
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user input in the selected units whenever a distance must be specified. HARP 
then converts the input to meters for all internal storage and calculations 
All distances internal to HARP are in meters. The conversion to meters if 
the user has specified some other distance units is taken care of automatically 
so the user need not be concerned about it. These preferred units can be 
changed at any time. This includes at any time in the middle of building 
an aircraft model. To work in inches, Option 3_2 would be invoked and the 
follow dialog would result: 

— ^ Default Units 


>< 1 > You want to work in meters. 

>< 2 > You want to work in centimeters. 
'< 3 > You want to work in feet. 

'< 4 > You want to work in inches. 


=> Enter option. ..[!]: 

From this point on, until a new preferred unit for distance is specified, HARP 
would request all distances needed in inches. 


4.3 3 3 Exit HARP to Your Shell 


Option 3_3 is intended to allow a temporary exit to the user’s default shell. 
This is especially useful when HARP is used in the full TekScreen mode 
where there is no other access to th e operating system. To resume HARP 


operations when finished, type | exit [ then hit return 


4.4 3_4 Submit Bug Report 

Sometimes the user may discover a problem with some aspect of HARP in the 
process of using it. If after reading this manual carefully the desired results 
cannot be obtained or if the user is convinced that a “bug” has been found, 
this option will allow a bug report to automatically be sent by email to the 
ElectroScience Lab at The Ohio State University where HARP is currently 
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j . /i HARP is a complex, tightly related group of 

bring upgraded “ d “Prove ^ AR ^ ^ any submitt ed bug report 

programs. Consequently, 1 y r tin a hues from good user 

be L specific and documented as p"" L 3.4 would 
reports is often the best way to ferret them out. InvoKi g P 

yield a dialog like following: 

=> Enter your bug report, and end with <CTRL>-D: 

r -r 

Then then press the Ctrl ana u * y 

AD 

This report will then be emailed to The Ohio State University ElectroScience 
T.ab. 


4.5 3_5 Predict MM Completion 

When Option 5.2 is used the predict the % “V^mtaufes 

an aircraft using the method are likely to be 

- 

the following to be printed to the screen. 

=>Matrix filled in approx. 27 minutes, 51 seconds, 

=»or at Fri Aug 7 14:59:54 PM. 

=>Code began Fri Aug 7 14:28:39 PM, 

=*and has used 3 minutes, 24 seconds. 

fnllowine: 


=^Run is complete. 
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If an error has 
printed: 


occurred anytime during the run the following would be 


^Errors occurred, listed in file esl.amc errors 
=? Aborting... 

In this case it is assumed that “pel” : e it , r tl 

£ r it T 2s £ 

screen with cat orp 3 * W “ h “ y edilor OT °° the 


4.6 


3_6 Archive/Recover Data 


HARP creates a large number of data files Manv nf m i 

various HARP options are exercised Tbi* r T ! ^ ^ ® S change as the 

=> Archive Control Menu 

=^h-el P) c-reate d-elete, 1-ist t-able x-tract, e-xit: 

=» Enter your choice [h-elp]: [return 


h-elp: The default operation is h-elp. Hitting (Tctuml or HTI (wl 

tzzg™* the mmu foi >S Si* 


s' h-elp display this message. 

=>c-reate create an archive of current data. 

, e ! e , te de , lete an "chive and/or files from one. 
=M-ist hst the available archives. 

=>t-able list the files in an archive. 

=»x-tract extract files from an archive. 
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=j>Upper or lower case letters may be used to denote option. 


=>Hit RETURN to continue 


c-reate: The c-reate operation is used to create a new archive that will in- 
clude all the files in the present working directory (pwd) with the current 
family name. For instance, if the current family name were ra h then all the 
files that matched “rah.*” would be picked up and placed m a, compressed 
file. Before HARP can create the archive file, however, a “tag” to further 
identify it must be supplied by the user. This tag is restricted to characters 
and/or numbers in any desired order, but must not be longer than 126 alpha- 
numeric characters in total. HARP takes the family name, appends this tag 
to it, and then appends “. archived ” to the end of this combination to arrive 
at the archive name. If an archive file already exists with this name, HARP 
will report this fact, and prevent any possibilit y of a dupli cate archive name 
being created in the same directory. By typing 1 c return] , an archive would 
be created like this: 


=» Current family name is rah. 

=>• Enter archive tag (126 chars max): 

=> Created archive: rah384b.archive.Z 


S84b 


=>Hit RETURN to continue. 


d-elete: The d-elete operation is used to delete any old archives that are no 
longer needed or to delete files that were extracted from an archive. See the 


section on x -tract. To delete an archive or its files, type 1 d return 


Number of archives: 3 


=*# 

Name 

Size 

Created 

=>0 

rahtestAl. archive. Z 

50979 

Tue Aug 4 18:50:54 1992 


lhl21. archive. Z 

50985 

Wed Sep 2 17:36:54 1992 

=>2 

esl044. archive. Z 

51009 

Wed Sep 2 17:56:55 1992 
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— ^ Enter the archive number to delete: |~j~| 
=>Delete the files from lhl21. archive. Z [n] ? 
=£•32 files deleted. 


0 


►Delete the archive lhl21.archive.Z [n] ? |jyJ 


►Delete any more files? [n] | return 


=*Hit RETURN to continue. 


In this case the archiver found no files from IhlSl.archive.Z, and reported 
this to the user. Had there been any files to delete, the archiver would have 
reported the number of files it deleted. There has been no provision made to 
delete individual files that were once part of an archive. 

I-ist: The l-ist operation lists the archive files found in the present working 
directory in exactly the same manner as previously shown for the d-elete op- 
eration. 


t-able: The t-able operation lists archive files found in the present working 
directory in exactly the same way as the d-elete and l-ist operations. A ta- 
ble of all the files contained in the selected archive is then presented on the 
screen. After listing the archives, HARP requests the number of the archive 
for which it should list the files. This number is listed on the far left of the 
screen under the # sign: 


►Archive number to table? [0] |Tj 


Simply hitting \ return] would table the zeroth archive, | 1 return] would table 
the next, and so on. 


x-tract: The x-tract operation is used to recover the files stored in an archive. 
Like the other archive operations, this one lists the archive files found. It 
then asks: 
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*■ Enter archive number to extract: 


2 


After writing the files, HARP then offers the opportunity to ch an ge the cur- 
rent family name (CFN) to this archive name: 


=>Change the CFN to esl044? [y] | return 

Here esl044 is the part of the archive name before the u .archive. Z ” part 
of the complete archive name. 


e-xit. When finished with the operations provided in the Archive Control 

' » * ' “ 1 

or 


Menu, simply type |e return! or q return 


4.7 3_7 Write Status File to Disk 

Option 3_7 is for conveniently extracting data from the various HARP database 
files and writing a summary page of this data to disk. 


Status Page 


►Choose t-erse, v-erbose [t]: [17 


At this point the user can decide if a terse summary consisting of only the 
major data will be written to disk or a far more verbose summary should 
be written. All user input other than [V] or [v] are defaulted to terse. 


=>Output desired: m-MM, u-UTD, b-oth, n-one [b]: [m] 


=> Enter an [m) if only MM data files are of interest, [u] if only the UTD 
data should be summarized, [b] for both types of data, and [n] if only data 
concerning the fuselage, fins, antenna, and rotor are of interest. Unexpected 
user inputs are defaulted to fbl. 


=^Output file: rah.status OK? [y]: |~n 
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All user input 


other than 


n 


or 


N 


is 


defaulted to j~y| . 


Enter output file name: 


mm- summary 


In this case the file mm-summary would be written to disk. If no file name 
is provided, the output summary is echoed to the screen. 


4.8 3_8 Set Temporary AMC Defaults 

Option 3_8 is used to write a temporary file that modifies the default set- 
tings for AMC when Option 5_2 is invoked. Specifically, it sets the values of 
the AMC WR and/or IN commands. [1] The menu structure for this option 
looks like the following: 


AMC Temporary 


Defaults Menu 


=>< 1 > 


=>< 2 > 



> 


Print the detailed description of the wire and plate 
geometry. This includes the coordinates of every plate 
and wire segment and the description of the MM modes. 
Write the current vector plus the wire and modal geometry 
to the output file. 

Write the impedance matrix to the output file. 

Caution: This results in N*N lines of output where 
N is the total number of MM modes. 


==>< 4 > Change the number of Simpson’s rule integration intervals 
— s. used for the wire-to-wire impedances. 

— s < 5 > Change the number of Simpson’s rule integration intervals 
— v. used in integrating over the surface patch monopoles. 


=> Enter your choice(s) [exit]: 


0 


A running summary of the set tings is d isplayed at the bottom of the page. 
To exit Option 3_8, simply hit return | when the desired options have been 
set. Note that the first three items are toggled between write and not set 
each time they are selected. In a similar fashion, items four and five can 
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set as many times as desired. Only those values set at exit are kept. The 
summary line would look like the following: 

— > New Settings: < 1 >= write < 2 >= not set < 3 >= not set < 4 >— 4 
< 5 >= 6 

Caution should be used when setting these new defaults because very large 
files or long compute times can result. See the AMC manual for further 
details. [1] 
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Chapter 5 

[4] Model Comparison Menu 


The Model Comparison Menu is arguably the most important menu of the 
HARP system. It is certainly the most used. This menu allows the user to 
view the aircraft models created from the cross-section files in 3D. From this 
menu antennas, fins, and rotor blades are created and/or specified for the 
“physical” model of the aircraft. The MM and UTD models can then be 
created and displayed in this menu by operations on this physical model. In 
addition to being able to view input and output models of the MM code and 
the input models of the UTD code, additional calculations are automatically 
made to generate data files that will serve as the input to the electromagnetic 
codes. This is one of the great strengths of HARP. It is important, however, 
to visually verify the quality and accuracy of these models before committing 
to a complete electromagnetic calculation which could take anywhere from a 
few minutes to several hours. Fortunately, another great strength of HARP 
is the ability to quickly and accurately view all aspects and all angles of the 
models with the powerful 3D graphics system. 


5.1 4_1 Add/Display Physical Features 

The basic physical body of the aircraft is created using Option 1_2 in Menu 
[1] described in Chapter 3. To this body there are three features that can 
be added to complete the model. The first of these features concerns fins. 
As stated before, fin here is a general term to describe wings, horizontal and 
vertical stabilizers, and other aircraft control surfaces. These fins are modeled 
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as planar quadrilateral plates that are then attached to the aircraft's physical 
b ° VhSeHrRP - LTt"eived y as l a'toTto predict -diation patterns 
fot 

t^ 0 ^ ^HARP^s^h^ 'nwd^'the'^otor hu^an^maiTTofrir 

hir re “he any desired £2^ 

^‘number of Wees like 

radiation pattern can be calculated is ^ other option in Menu 

have specified an antenna in p HARP monopole antennas of 

[4] can be invoked. In the present version versions 

arbitrary length, orientation, and location can P 

of HARP are planned which can deal with other antenna ypes. 

5 1.1 Fin Operations 

After invoking Option 4.1 the first thing the user is presented with is the 

Fin Control Menu: 

< 1 > Read in the fin family data file. 

< 2 > Enter/edit fin data. 

< 3 > Forget about fins for now. 


J / A 

If one types ffl followed by ® > HARP " » the fin d*a from 

Control Menu f^^ef message indicafrng 

that the fin file does not exist. If one does no h and 

display the fins in the current fin file, one can si p y yp U ^ 

Tn enter new fins or to modify previously entered fin , yp |_J , J 

To enter ne r «ih” and that there is no fin file, the 

Assuming a curren y , . « 2 » would be the following: 

first thing the user would see upon selecting l 
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=^File lh.fins does NOT exist. 

=£• Enter new fins now [Y] ? [ return 


desir e ed re at P this e t t0 ^ " negatiVe ’ HARP that no fins are 

will be seen: contmues. If the response is positive the following 


=>On the tablet, enter two points a know distance apart. 

the SCale of the dewing so that dimensions taken from the 
tablet wdl be correct. Any known distance on the drawing or blueprint wdl 

diglfetg STo^k diSla " Ce " m ^ k ' d by alig,ling lh ' crosshairs °° “>e 

g zing puck at one known point and pressing the YELLOW button tk- n 
movrng to another known point and pressing tie YELLoTbut n ag^ 

SySTjT !UPP,y the “ ' Cik P** inle 


> Enter this distance in meters: [ 3. 20^ 


Here it is assumed that the preferred units are Tk a a 

Of marking the four corners^ the ^ 

=>Enter the leading attachment point on the tablet. 

=> Enter the trailing attachment point. 

=k Enter the trailing unattached point and the leading unattached point. 
Leading and trailing attachment points are the fore and aft corners of the 

£ ^ -rS? 

depress°the YELLOW - ““ **** ^ P** - 


> Enter fin leading y value in meters: [2.713 


Semd "like 1 Illth ° f ‘ be ‘"“““S 4tUch ' d of the fin just 

in the u,“ e pltL “ req “ e,led ^ HARP ,hiS ~ 


HARP User’s Guide 


42 



CHAPTER 5. [4] MODEL COMPARISON MENU 



Figure 5.1: The attachment point specifications for the fins. 
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=>Fin attachment angle from +x-axis around body (degrees): 


90 


Picture a ring surrounding the aircraft not unlike the ring on your finger. This 
attachment angle is the connection point in degrees where the fin contacts the 
body of the aircraft. The starting point is the +x-axis which is directly to the 
aircraft’s port side. The degrees then increase as we sweep along the ring di- 
rectly overhead to 90 degrees. Continuing the swing directly to the starboard 
side we have 180 degrees. Directly beneath the aircraft we have 270 degrees 
and finally back to the port side we have 360 degrees. All angles requested 
by HARP should normally be supplied in the range of [0.0,360.0] degrees, 
but negative angles are acceptable. This attachment angle is ^ in Figure 5.2. 


Fin inclination from +x-axis (degrees): 


0.0 


This second angle is shown as fi in Figure 5.2. It determines the orientation 
of the fin. 90.0 degrees will orient the fin vertically straight up. 0.0 degrees 
will make the fin stick out to the port side parallel to the x-axis. A fin that 
is attached to the underside of the aircraft and is pointing straight down 
would be specified with an angle of 270 degrees. Any angle in the range of 
[0.0, 360.0] degrees is acceptable. The user, however, must be cognizant of 
the attachment point of the fin because it is possible to specify angles which 
would place the fin inside the aircraft. For instance, if the fin were attached 
on top the aircraft at 90.0 degrees, but the inclination angle were specified 
as 270.0 degrees, instead of sticking out from the aircraft, the fin would be 
inside the aircraft and may not be visible at all. 


'Enter the fin description tag now: 


Some user string 


The tag is a string up to 50 characters long used to help the user identify 
what the fin is or where it is located. This tag can prove useful when editing 
the fin database. 


'Enter more fins [Y] ? n return 


At this point if no more fins are to be entered, answer | n | or | N | and return 


If more fins are to be entered, simply hit | return [ and above cycle will repeat 
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itself. 


If a fin file already exists when “2” is selected from the Fin Control Menu 
the following Fin Editing Menu is presented: 


1-ist, d-elete, t-oggle, a-dd, m-irror, e-xit 


Enter you choice now \L\: | return 


1-ist: If the default is chosen by hitting | return | or Q] and | return |, H ARP 
will report the number if fins defined in the fin file and request return again 
before reporting all relevant data on the fins defined. These data are listed 
in six columns for each fin defined. The first column, labeled “No.”, lists the 
fin number. The second column,” Active”, contains a “Y” or “N” indicating 
whether the indicated fin should or should not be included in the displayed 
graphics or electromagnetic calculations. The next column contains the “Y- 
coordinate” of the leading attachment point of the fin on the aircraft body. 
The “Roll angle” is next, and is identical to the angle in Figure 5.2. This 
is the fin attachment angle around the body in degrees from the -l-x-axis. 
The “Inclination” is listed in the next column and is the same as angle fi in 
Figure 5.2. The entry in the last column is the “Description” string of the fin. 
This is the “tag” the user may have entered to describe the fin or its location. 


d-elete: The d elete option under the Fin Editing IVfenu is used to com- 
pletely remove a fin entry in the fin data file. The number of the fin to be 
deleted will be requested. This number is the same as that listed in the 
first column when the l-ist option is invoked. Invoking the l-ist option after 
deleting a fin will cause a “D” to be displayed in the second column instead 
of the Y or N usually found there. This means that fin’s data entries are 
marked for deletion. While there is no un-delete option, nothing is actually 
deleted until conformation of all changes is made during the e-xit from this 
menu. 


t-oggle: The t-oggle option is used to toggle the specified fin to the active to 
the inactive state, or visa versa. All fins when first created are in the active 
state. Only active fins are displayed by the graphics system or are included 
in any field calculations. To determine if a fin is active or not see the second 
column of the output provided by the l-ist option. If a file is active a “Y” 


HARP User’s Guide 


46 





will be shown in this column. An inactive fin will 1 be shown by a “N’ m this 

ttszrszt : st “ rr £ — — 

loosing previous work. 

a-dd: The a-dd option allows * new fin to 

"nsttt^ Sly fa” R^but «* «" th ‘“ 50 “ b ' * 

any time. 

* TVip nort (+x axis) and starboard (-x axis) sides of an aircraft are 
m-irror The port (+x a ) bodies exhibltmg struc- 

usually but not always identical. For tho = ■“? id of the aircraft 

tural symmetry, any fin that has been en ered to edher s,de 
can be mirrored to the other side wrthout having to .re ’enter the^ ^ ^ 

. , i ui-i The m-irror option creates a new entry 1 , 

specified fin. This is accomplished 

° f T 6 Whde H ARP wtrlllow fins completely in the yz-plane to be mir- 
^^th"" done because it > — — 
two identical fins in the same location on the ” keep the 

problems m the e]ec * Iom * g ™ ^^aftbody that does not exhibit symmetry, 

srir rrs; .. - — ** 


► Save your changes [Y] ? [return 


code. 
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5.1.2 Antenna Operations 


Me" u “ mPle ‘ ing fi " ° Perllio ” S lha — “ P— W with the Antenna 

< 1 > Use family antenna data file. 

< 2 > Pick a new antenna location. 

^ ^ ' > Forget the antenna for now. 

Entering a JT] followed by a j return I will cause HARP f ., 

antenna data file. If no antenna H ARP w^lnt a b i f 

gating that the file does not exist and 

then typing 0 fX»ed byThe Zll otl^Th' “* T 

systent will then display the physical sa3n antennf tZ 

however, that an antenna must be chosen before anv of the Jlf J l 

vZLTrfHATp'lfi 0 ' tef T ^ fieW Calculations ““ be "ade. Thfpfesent 
family nine 7 ° ne *° be ■»"*“ at * for each 

need S t C be 1 ?up 0 plied dfy ‘ ”* “ tenn *' "" “"*« info "” ati °” will then 


^ Enter antenna y value in meters: 


1.7346 


are meiers Md ihe y “ Mdinata «» ■». 


> Attachment angle from + x-axis around body (degrees): \J 4 T 4 


*v ' ang ! e ^ j r USt Hke s P ecif y in g attachment angle for fins In 
gure 5.2 this angle is tf. The acceptable range is [0.0,360.0] degrees. 


►Enter the antenna length in meters: f 0.812 


Again, the user’s preferred units are meters Tti#. an+a» 1 .1 

specified in absolute distance and not in some relat^taSikeTb 
cause the antenna length is fixed and no frequency of operation has yet b«n 
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specified. 

=> Enter angle with + x-axis (phi): | 50.5 

This is the angle in degrees in the xy-plane starting on the + x-axis and mov- 
ing counter-clockwise. It represents the angle the antenna is “pointing in 
projected onto the xy-plane. The acceptable range for this angle is [0.0, 360.0] 
degrees. Most people trained in electrical engineering recognize this angle as 

f 

=>Enter angle with + z-axis (theta): 10. 711 

This is the angle in degrees from the + z-axis that the antenna would make if 
its base were at the origin. The acceptable range for this angle is [0.0, 180.0] 
degrees. Most engineers recognize this angle as 6. The angles <f> and 8 are the 
normal coordinate angles used in 3D. They are shown in Figure 6.1. Note 
that in the UTD portion of this code, it is assumed that the monopole an- 
tenna is pointed in the direction normal to the surface. Thus, the angles with 
respect to the x- and z-axis will no be used when the NEWAIR code is run. 

All the information necessary to specify the antenna has now been collected. 
It is necessary to save this information to a file to do any field calculations, 
however, it is not necessary to save the data to a file if only displaying the 
antenna is desired. Since the data will almost always want to be saved, the 
following questio n comes up with a default affirmative reply that can be ac- 
cepted by hitting [return . 

— ^. Do you want to save the antenna data to a file? [T] | return 


5.1.3 Rotor Assembly Operations 

The rotor assembly of a helicopter is quite complex. HARP can model this 
assembly with any number of main rotor blades both graphically and elec- 
trically. After having specified the antenna, the user can now specify the 
number and shape of the main rotor blades from the Rotor Blade Menu: 
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< 1 > Use family rotor blade file. 

< 2 > Enter new blades from the tablet. 


< 3 > Forget about rotor blades for now. 

Like the other specification menus under Option 4_1, 1 return picks up 
the data from the family rotor file and 3 return simply skips over the need 
to specify a rotor, such as when the aircraft does not contain rotor blades. 

To enter a new rotor geometry 2 return is typed. The following inputs 
must then be supplied: 


=^0n the tablet, enter two points a known distance apart. 

Just as in Section 5.1.1 for specifying the scale for the fins, this now sets the 
drawing scale for the rotor blades. 


=>• Enter this distance in meters: 


S3. 564 


The user’s preferred units are meters here but could just as easily have been 
inches, feet, or centimeters as set by Option 3_2. After this scale has been 
set the actual shape of the blade can be entered on the tablet. 


Enter 4 or 6 points describing the blade, starting at the 
rotor end, continue clockwise as viewed from the top, 
and finish at the rotor end with the BLUE button. 


If the blade is essentially straight or has a linear taper then 4 points can be 
used to describe the blade. If the blade has a raked end then 6 points must be 
used. All the points are digitized by lining up the crosshairs of the puck and 
pressing the YELLOW button except for the last point digitized. The last 
point must be digitized using the BLUE button on the puck. It is important 
the points digitized start at the rotor and proceed outward and move in a 
clockwise fashion, returning to the rotor end for the last point. After this 
geometry has been entered, additional information will be requested: 

=> Enter the number of blades on the rotor: [Tl 
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HARP will accept any number of rotor blades in the range [1, 10]. 


=>• Enter the y-location of the rotor in meters: | 5.67 1 

This is the y coordinate of the base of the rotor assembly requested in the 
user’s preferred units. 


►Enter the phi location for the rotor in degrees: | 00 


This is the attachment angle from the + x-axis around the helicopter body. 
The angle requested here is the angle $ in Figure 5.3. While no default 
angle is set, it is expected that the user will almost always choose 90 degrees 
because this angle places the rotor at the top of the aircraft. Any angle in 
the range [0.0,360.0] degrees is acceptable. A more realistic range, however, 
is [80.0, 100.0] degrees. This can be used to slightly offset the rotor from the 
axis of symmetry of the helicopter. 


> Enter the height of the rotor in meters: 0.55 


This is the vertical height of the rotor blades from the point of intersection 
of the surface of the helicopter and the vector from the origin of the xz-plane 
at the y-location, out through the body at an angle phi from the x-axis as 
specified above. In other words, this is the distance from normal plane at 
the base of the rotor assembly where the rotor attaches to the fuselage and 
the plane swept out by the rotor blades as shown in Figure 5.3. 


=>-Do you wish to save the blade data to a file? [V] [ return 


Hit | return | to take the default response to save the rotor data to the 
family rotor file. 


5.2 4_2 Generate/Display MM Input Model 

Option 4_2 is for generating the Method of Moments (MM) Aircraft Modeling 
Code (AMC) code input file, and for viewing the input model that HARP 
generates for it. The model is generated from the physical body built in 
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Figure 5.3: The angle and height specifications for the rotor assembly. 
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Option 1 2 and from additional feature, added in Option 4.1 as well as other 

' .erotorareaahed 

about its orientation: 

=> Enter the desired angle of the first rotor blade 

• / * J in Hi* reti 


hunter tne aesircu a — . — — — 

with the positive x-axis (in degrees) [0.0]: [retv ,rn 


r.=,r-r rv ^ 

to port, parallel to the positive ^ th 8 roug h the center of the rotor 

h T t TmI 

=0 Enter the desired fore-aft rotor tilt (in degrees) [0.0): [HI 

, , i r laflps can be tilted forward or backward any 
The entire rotor assembly and blades th eir flight position. The 

number of positive or negative degrees to simulate therr^ g ^ ^ ^ f _ 

angle requested is that angle in e 6 r “ ;t conUcts the aircraft 

axis through the base of t e ro or ^ ass ^ While there are no 

body and the axis of rotation of tbs rotor ^ fce ^ 10 . 0 , 

restrictions on the ang^ccep^ # ^ ^ entered simply by hitting 

S Warning! It is very easy to 

“ b ^tl tht occur. tL resmts 

of the field calculations may not be accurate. 


=»Enter 6 to 16 body sides [10]: 

wh«l n is the number of sides requested. The acceptable 
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range for n is [6,16] and the default is 10 sides. Generally, the greater the 

HeTtoth. 8 J 6reater ‘ he MCUraCy ° f lhe field results . also the 

greater the required computer storage and CPU time. In all cases the num 

, b " it: r, b t : r to or greaier iha ° 1 3 


-Enter frequency (MHz): I 8^.667 


The MM body created depends on the frequency at which the field calcu- 

If “ " .*? b ‘^ l hmiOK ’ IUS fre< >““ cy » Megahertz is the slme 
f „ h ‘ C , h Wl f 5 used ®ake the field calculations later with Option 
tpted CalCulal, ° n! this is lhe «* point at which the frequency can 

=J- Enter segmentation size in lambdas between cross-sections [0.2]: 


0.25 


Jf h t e he r h S 7 eCti0nS H ^ RP CreatCS ParaUel t0 the xz ‘P lane down the length 
•ectionlmLn SPa 7b aCCMding '° fre,,UenCJr - This -Pacing between cross- 
t' [‘ ° j ( . “ ‘ he raDge > 0 lo 0 25 Inputs outside this range are 

trapped and the user is requested to reenter a number within this range 6 The 

default value of 0.2A is acceptable for most calculations. While additional 
accuracy may be obtained with a smaller fraction of a A comnutatiol Um] 

whik harp 


=>• Making moment method model, please wait... 

C F : r; D °; c l a d CCU T r h aCy Calculated Md r**™. « attachment mode 
p cified. This attachment mode is a current disk at the base of the 
antenna that has a radius of typically 0.10 to 0.20 A. It’s purpose is to enforce 
con inuity of current at the antenna/fuselage junction. For the attachment 

s? * - - - a ££ 


=> Enter the attachment radius in meters ( 0 = none ) [ 2.4148 ]: 


1 2. 371 1 


HARP calculates the maximum attachment mode radius based upon the size 
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and “flatness” of the fuselage at the attachment point. If this radi us is be- 

" _ . • , « « « i i • 1 1 1 


tween 0.1 and 0.2A it is suggested that the user accept it by hi tting \rxturn 
If some other radius is desired, like 2.25 meters, si mply enter | 2.25 retur n 


If no attachment mode is desired, enter [0 return | . If the suggested radius 
is less than 0.1 A, the use of an attachment mode is not recommended. The 
attachment disk radius should never exceed 0.25A. The user is cautioned 
that, in some (rare) cases, the use of an attachment mode appears to have 
made results worse, and thus it should be used with caution. A problem is 
indicated if the computed patterns change significantly as the attachment 
disk radius is changed. 


5.3 4_3 Calculate UTD Ellipsoid 

To make high frequency (i.e., when the size of the body is several A or more) 
field calculations the Method of Moments becomes impractical because the 
time and computer resources needed to complete these calculations becomes 
too great. In the high frequency regime it is suggested that field calculations 
be made with the NEWAIR code, which is based upon the Uniform The- 
ory of Diffraction (UTD). In the UTD branch of HARP, the surface of the 
aircraft fuselage in the vicinity of the antenna attachment point is modeled 
very accurately with a composite ellipsoid . The remainder of the fuselage 
and the wings and fins can be more crudely modeled by flat plates. The 
radiation patterns are then computed using the ellipsoid and flat plates in 
place of the actual physical model. This composite ellipsoid is actually two 
ellipsoids joined together at the antenna location in such a manner that their 
first derivatives are matched at that their union. Option 4_3 invokes a series 
of menus and submenus with many options and paths possible to achieve 
the ultimate goal of calculating the parameters of this composite ellipsoid so 
that it is a good model of the fuselage near the antenna attachment point. 
Fortunately, very good results can usually be obtained with the default re- 
sponses. The following represents what the user is most likely to encounter. 


►Enter Frequency (MHz): 


1275 


The frequency must always be specified in Megahertz. This frequency is 
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identical to that at which the fields will be calculated using Option 5_3. This 
frequency also sets the distance away from the antenna location on the sur- 
face of the body that the ellipsoid will try to match the surface. After the 
frequency is entered, the cross-section at the y location of the antenna is 
displayed in white and the region to be matched by the ellipse in RED. The 
user is next presented with three general methods to find the ellipse that best 
matches the cross-section cut in the xz-plane: 

=J>Methods for the X-Z ellipse: 

=»1 = rotated ellipse [default] 

=>•2 = non-rotated ellipse 
=>3 = big circle 

Of these three methods, 1 1 1 is the most general and usually gives the best 
fitting ellipse to the aircraft surface. This option allows the xz-plane ellipse 
to roll in the xz-plane to conform to the fuselage cross-section at the y coor- 
dinate of the antenna. By selecting [2] the non-rotated ellipse is calculated. 
This non-rotated ellipse will always have its major and minor axes parallel 
to the x and z-axes. At certain locations on an aircraft an ellipse may not be 
a good fit. In this case [3] may be used to generate a "big circle” approxima- 
tion. After one of these methods is selected the program will calculate and 
display the best fit ellipse in GREEN. Probably more than any other param- 
eter, the ellipse fit is dependent upon the extent of the cross-section which 
the ellipse is attempting to match, i.e., the RED region of the cross-section. 
If the fit is not satisfactory, then one must either choose a different method 
for the x-z ellipse fit or adjust the size or extent of this RED region. HARP 
now requests further instructions: 


► Repeat the X-Z ellipse process? t/f [fj: | return 


If the ellipse displ ayed is s atisfactory simply hit | return] . If a better fit is 
desired, hit 1 1 [ and vet uni] for the following choices in two menus: 

==> Options to modify the match points: 


1 .) 

2 -) 


Antenna near corner 
More local fit desired 
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=»3.) Antenna on concave/convex boundary 
=>4.) Additional permutation 
— ^5 ) Return to original contour 
— >6 ) No change [default] 

This first menu controls the 

used for matching for a new e ips , > expec t e d from is descriptive 

functions of each ^ — t near a corner or 

line. For example option | — j nri w :ii ma ke the red region 

sharp bend in the fuseiage eross-sjtiom^ P^°. □ & ^ gbbal fit . 0 nly 

smaller, resulting in a better lo > met hod used to compute the 

one of these items can be selected at a trme. The "ethod^ fi mpse is 

for the ellipse: 


==»Options for ellipses. 


k\ ) Force outside ellipse inside contour 

k 1 } ) Additional permutation 

— a»3 ) Return to original parameters 
=$>4.) Change big circle radius multiplier 
— »5.) No change [default] 


sawr»K-»,assss 

It^etThle two menus can be seen. The user then comes bade to: 


=» Repeat the X-Z ellipse process? t/f [f]: [mtu™] 

If Qis again selected, the HARP loops back through the precedmg menus for 


HARP User’s Guide 


57 



CHAPTER 5. [4| MODEL COMPARISON MENU 


additional iterations. If the default is selected then the ellipse in the “Y R” 
Plane ,s calculated and displayed and the user has the following 

=» Repeat the Y-R ellipse process? t/f ff] : [retum\ 

J^! S Y '^ elIl P ses are the ellipses orthogonal to the X-Z ellipse such that to- 
g er ey make up the composite ellipsoid in 3D The "Y R” 
intersection of the body of the aircraft with th 1 Y . P ^ 1S the 

the antenna position 1 the c^tfThe X TfT™* T ^ 

to repeat this ellipse process, yet another menut p^entld' "" W,Sh 

=>Options to modify the Y-R ellipses: 

=^1.) Antenna near a sharp turn 
=$■2.) Additional permutation 
=>•3.) Return to original contour 

=»4.) Increase width (in y) of ellipse =»4.) No change [default] 


Rep eat the Y-R ellipse process? t/f [f] : [return 

Assuming the default is accepted, the 
for Option 4_3: 


user is presented with the final menu 


=»Options to repeat Composite Ellipse path: 

=>1.) Repeat, with new X-Z and Y-R ellipses 
=*►2.) Repeat, with only a new Y-R ellipse 
— ^3.) Finished [default] 

Choice □ will start all over from the beginning. Choice @ will start over 
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with the Y-R ellipses. And the third choice is the final and only exit from 
Option 4_3. 


5.4 4_4 Calculate UTD Plates 

The UTD code (NEWAIR) [2] employed by HARP usually makes use of flat 
plates to represent aircraft surfaces and to provide other functions. Option 
4 4 provides the user with an automatic way to generate these plates. It 
is important to keep in mind that this option generates plates to improve 
the high frequency model of the fuselage of the aircraft and it is not to be 
confused with Option 4_1 where flat plates are also used to model fins and 
rotor blades. This option was developed because, in many situations, the 
composite ellipsoid is not sufficient to accurately model the fuselage. The 
plates generated by this option are triangular in shape and are a function of 
the aircraft geometry, composite ellipsoid, and user input. Option 4_3 must 
have been successfully completed before Option 4_4 can be used to generate 
these plates because the ellipsoid data must be available. Upon invocation 
something like the following will appear on the screen: 


— S>The body y-minimum = 2.500000 
=»The body y-maximum = 60.00000 
=>-The antenna y-position = 15.00000 


The ellipse y-minimum = 9.679076 

The ellipse y-maximum = 43.24205 

Enter the v-stations [return to end]: 
i 7~r~z ; 1 


=>• Enter y-station 1 
==> Enter y-station 2 : 
=i> Enter y-station 3 : 
=>Enter y-station 4 : 


JO, 5 return 
15.0 return 


JO.O return 


return 


Making plates now... 

=>• Total number of triangular plates generated: 23 

A general rule for selecting the y-stations is to pick one about one wavelength 
to the right of the ellipse y-minimum, another near the antenna location, and 
a final y-station about one wavelength to the left of the ellipse y-maximum. 


HARP User’s Guide 


59 



CHAPTER 5. [4] MODEL COMPARISON MENU 


Note that all these y-stations must be separated by a distance of about one 
wavelength. Warning! This option is still in the development stage. It is 
possible for this option to generate plate configurations that do not satisfy 
the constraints placed on plates by the NEWAIR code. When this occurs 
the NEWAIR code will fail and leave a brief explanation in the error file. If 
no plates are needed for the current model, this option can be skipped. 


5.5 4_5 Display UTD Body 

Option 4_5 assembles all available data (ellipsoid and flat plates) for the 
aircraft and presents it together in 3D. The chief value of this Option is to 
be able to see the composite ellipsoid created in Option 4_3 superimposed on 
the physical model of the aircraft. In this way, not only can the quality and 
appropriateness of the composite ellipsoid be ascertained, but the closeness of 
this ellipsoid’s match to the physical surface of the aircraft becomes apparent. 
The composite ellipsoid is shown in BLUE and the physical body of the 
aircraft is displayed in a pseudo-translucent GRAY. Any plates created by 
Option 4_4 are displayed in RED. Like most graphics displays in HARP there 
are a number of function keys to toggle certain features of the display and 
fully programmed dial box functions that are used to manipulate the figure 
in 3D. These features are completely described in Appendix A. 


5.6 4_6 Enter Towelbar Antenna 

With this Option the user can create a “towelbar” antenna that can be used 
in place of the monopole created under Option 4_1. This antenna is actu- 
ally a wire antenna composed of linear segments with vertices at arbitrary 
locations in 3D space that the user selects. At each vertex the user is asked 
of a source should be placed at that point. No matter how many segments 
are used to make up an antenna, only one source can be specified. Once 
specified, this source is marked with a Q on the screen. A typical invocation 
would look like this: 


►Enter Y location in inches: 


10 return 
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► Enter angle around body in degrees: 15.0 return 


► Enter height above body in inches: 8 return 


►Accept this point? [y] return 


►Is there a source this point? [n] return 


►Enter more points? [yf return 


After the user has finished entering the vertices, a data file is written that 
will optionally be picked up when the user invokes Option 4_2. 
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Chapter 6 

[5] Field Calculation Menu 


Up to this point everything has been in preparation for the electromagnetic 
field calculations. From Menu [5] all field calculations are initiated. There 
are three options in the menu. Two of them are for the field calculations 
and the other to verify the MM geometry. While the later may seem out of 
place in this menu, it is grouped here because it actually employs the scone 
program (AMC). Options 5J and 5_2 exercise different aspects of the same 
computer code. 

6.1 5_1 Build/Show MM Graphics 

Option 4_2 prepares the input file for the MM code and then displays the 
input model. To see what the MM code “thinks” this model is, Option 5_1 is 
used. This option creates and/or displays this output model which is created 
by the MM code itself. Option 5_1 also provides a quick method to check 
that the input file is syntactically correct and that the host computer has 
enough RAM and other resources to at least start the MM calculation. It is 
assumed that the user will almost always make this so-called pre-run to verify 
the geometry and correctness of the input before making a full MM calcula- 
tion using Option 5_2 which could take minutes to hours to complete. Upon 
invoking Option 5_1 the user is presented with the Verify AMC Model 
Menu: 

< 1 > Build/show new geometry w/o current modes. 
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< 2 > Build/show new geometry with current modes. 

< 3 > Show prior geometry w/o current modes. 

< 4 > Show prior geometry with current modes. 

< 5 > Abort with no further action. 

Those options not possible will be *’d out, that is, the numbers of those 
operations not possible will be replaced by *s. For example, if Option 4 2 
had not yet been invoked, no AMC input file would exit so neither of the 
first two operations would be possible. Similarly, if operation one or two of 
Option 5_1 had never been invoked, then neither operation three nor four 
would be possible because no prior geometry file would exist. 

The first four operations under Option 5_1 display the wire and polygonal 
plate geometry of the model that the AMC code will use in solving for the 
field patterns. Operations one and three simply show the polygonal plates, 
while operations two and four include arrows which illustrate how the current 
on the plates is represented by MM surface patch expansion functions. Note 
that this is an output from AMC and not the input geometry These models 
are constructed from data contained in output files generated by the AMC 
code. Consequently, Option 5.1 or 5_2 must be run before these models can 
be displayed. Typically the user will run Option 5_1, which takes very little 
computer time, and compare the results with the model previously rendered 
with Option 4_2. If visual inspection shows the models to be consistent, the 
user can then "commit to the more time consuming Option 5_2 to calculate 

the field pattern. , . , 

Operations two and four show the quadrilateral surface patch model of 

the aircraft, with the MM current modes indicated by small BLUE arrows. 
Wires (for the antenna or rotor blades) are shown as RED lines. Operations 
one and three are identical to two and four except the arrows representing 
the current modes are not shown. This presents a cleaner appearance when 

only the geometry is of interest. , . 

The fifth operation provided in this submenu allows the user to safely 

abort Option 5_1 with no file changes or graphics attempted. 
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6.2 5 2 Do MM Calculation 

Option 5_2 is used to initiate the full Method of Moments calculation of 
the desired field patterns using the model previously created in Option 4_2 
and additional data requested upon invocation. Note that the frequency at 
which these calculations will be made has already been selected when the 
MM model was created using Option 4_2 and can not be changed at this 
point. This is because the MM surface patch model itself is frequency de- 
pendent. Since this model may have been created some time ago, the user is 
reminded of this frequency upon invocation of this option: 


=>■ Frequency = 932.250 MHz 


6.2.1 Specifying the Pattern Cut 

The pattern cuts for the field calculations are selected next. There are two 
basic pattern cuts that can be specified. See Figure 6.1. The usual spher- 
ical coordinates are used where 0 is measured from the positive z-axis and 
$ is measured from the positive x-axis in the direction shown. The first of 
these pattern cuts is an azimuth-cut where the angle 0 is fixed $ is varied 
over the range 0 < $ < 360 degrees. The angle 0 can range from 0 to 180 
degrees. For angles < 90 degrees, the field pattern would lie on the cone 
shown in Figure 6.2. At © = 90 degrees, the pattern would lie entirely in the 
xy-plane. For angles > 90 degrees, the pattern would lie on the cone aligned 
in the opposite direction to the one shown. The second of these pattern cuts 
is an elevation-cut. For an elevation-cut $ is fixed and 0 is varied over the 
range 0 < 0 < 180 degrees, and then $ is increased by 180 degrees and 0 is 
varied over the range 180 > 0 > 0 degrees. With $ = 135 degrees, the field 
pattern would lie in the plane of the circle in Figure 6.3. An elevation-cut at 
$ — 90 (top to tail to bottom to nose to top) is commonly referred to as an 
elevation plane pattern. An elevation-cut at $ = 0° (top to wing to bottom 
to wing to top) is commonly referred to as a roll plane pattern. 

=$■ Available Pattern Cuts: 

=►1.) Theta fixed (az-cut) 
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=$►2.) Phi fixed (el-cut) 

=£•3.) Abort run 

Selecting [T] means that the user wishes to fix the 0 angle in the usual co- 
ordinate system used for field calculations. This is usually referred to as 
an azimuthal-cut pattern. Choosing [2] means that an elevation-cut pattern 
is desired. Here the angle $ is fixed. To abort the field calculation [ 3 ] is used. 

if CD is selected for an azimuth-cut then the following pattern angle and in- 
crement are requested: 


6S.4 


►Enter theta fixed angle now (in degrees) [90.0]: 

►Enter the incremental step size in the theta fixed plane 
► (in degrees) [5.0]: 


10 


The defaults in square brackets can be entered simply by hitting return . If 
other values are desired they can be entered followed by return . Note that 


the increment size must be evenly divisible into 360 degrees. If the user’s 
input is not evenly divisible into 360, the same request will be made repeat- 
edly until this condition is satisfied. 

If 1~2~] is selected for an elevation-cut, the following data must be supplied: 


►Enter phi fixed angle now (in degrees) [0.0]: 1 1S5 


►Enter the incremental step size in the phi fixed plane 
► (in degrees) [5.0]: pg] 


6.2.2 Saving and Reusing the MM Impedance Matrix 

A large part of the time needed to compute the radiation pattern is consumed 
in filling and LU decomposing the impedance matrix. If the present run is 
for a geometry identical to a previous run, except for a possible change in the 
antenna location or its length or the rotor blade position, much of this time 
can be saved by reusing the LU decomposition of the impedance matrix from 
this previous run (assuming that this matrix has been saved). Only part of 
this matrix must be re-computed in this situation, saving time. Thus, the 
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Figure 6.3: Elevation-cut: Constant $ = 135 degrees, 0 < © < 180 degrees 

for and 180 > 0 > 0 degrees for $ + 180 degrees. This yields a full 360 
degree coverage in the plane of the circle. 
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next question the user sees asks: 


► Do you want to read or write the [Z] matrix? [N] | y return 


If the default answer is accepted, the Moment Method code is immediately 
started as a background job and the user is returned to Menu [5]. If an affir- 
mative response is given then the following questions are asked: 


==>Do you want to write the [Z] matrix? [N] y return 
If a matrix file already exists: 


► Do you want to read the [Z] matrix from the disk? [N] [ return 


If the response is affirmative then the following must be determined: 


►Has the antenna and/or the rotor changed? [Y] | return 


If affirmative, the elements of [Z] involving the antenna and/or rotor will be 
re-computed. 


► Has anything changed? [N] | return 


To reuse the impedance matrix the model must not have changed in any way 
except for the antenna and/or the rotor assembly. Specifically, the frequency 
must be identical , the number of sides to the MM model must be identical 
and be made from the identical physical body. Finally, the fins attached to 
the body must have changed neither their geometry nor position. In short, 
the model must be identical to the one which stored the [Z] matrix to disk 
except for changes to the antenna and/or rotor geometry or position. After 
this last question has been answered, the Moment Method code is started as 
a background job and the user is returned to Menu [5]. 
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6.3 5_3 Do UTD Calculation 

Option 5_3 is for making the high frequency UTD calculations. Like Option 
5_2 additional information must be provided after a reminder is displayed of 
the frequency at which the UTD model was created: 

=»Frequency = 2142.250 MHz 

The pattern cuts for the field calculations are selected next: 

=>■ Available Pattern Cuts: 

=>1.) Theta fixed (az-cut) 

=>•2.) Phi fixed (el-cut) 

=>■3.) Abort run 

These cuts are exactly like those discussed in Section 6.2 for Option 5_2. 
Unlike for the MM code, however, there are no specifications neede*d for the 
incremental step size in the fixed plane nor are there questions concerning 
an impedance matrix because none is used. Another chief difference between 
the UTD code and the MM code is the speed of calculation. Because the 
UTD code is able to complete the field calculations in much less time, it is 
not started as a background job. The user is returned to Menu [5] after the 
calculations have been successfully completed. One caveat: It is easy to forget 
when making a UTD calculation that in the NEWAIR code, it is assumed 
that the antenna length is < Thus, for the results of the calculation to 
be valid, a new antenna length should be specified using Option 4_1 if the 
current antenna is too long. 
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[6] Field Display Menu 


For graphical display of the calculated field patterns and for h ^dcopy output 
of these results, Menu [6] provides identical options for both the MM an 
UTD output data files. The screen plots are quick and require no additional 
user input. Additional flexibility has been added to the hardcopy options to 
allow the user to select polarization and scaling as well as output formats. 
Plots can also be automatically directed to a printer. 


7.1 6_1 In-situ Plot MM Results 

Option 6.1 displays the results of the latest MM field calculation on the 
screen in 3D. The physical model of the aircraft is displayed in the middle 
of the screen and the magnitude of the field strength is displayed around 
this model in the cut plane for which it was calculated. Both polarizations 
are loaded into the graphics system at the same time and can be toggled 
using the keyboard function keys as described in Chapter 8. Note that the 
polarization is indicated by the RED arrow on the right side of the plot field. 


7.2 6_2 In-situ Plot UTD Results 

In all respects Option 6_2 is identical to Option 6_1 except that it reads the 
data file from the UTD code instead of the MM code. 
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7.3 6_3 Hard Copy MM Results 

The hardcopy output from HARP is very flexible in that it can create output 
in a variety of formats that can be processed by other software. It is also 
possible to have output automatically queued to a postscript capable printer. 
When Option 6_3 is first invoked the following is displayed on the screen: 

=»Processing data from the lh family: 

Here it is assumed that the family name is lh. Then the polarization is se- 
lected: 


►Select Polarization: 


=$T) Theta 
=►2) Phi 
=»3) Both 

=*►4) Abort plotting routine 

The default, [T), selects the theta polarization. If another family name is 
desired (_4J can be selected to abort the program. Option 3_1 could then be 
used to set a new family name. Assume [J] was selected to plot both po- 
larizations, then the user has a choice of automatically scaling the gain or 
setting it manually: 

=»Auto scale gain [y]: | n return 

To_ scale t hejalot manually, the user should enter an [n] and follow it with 
a [return j. The default can be selected as usual by hitting | return I alone 
Assuming the user has decided to scale the plot manually, the following 
statements appear on the screen indicating the range of the gain in dB data 
for each polarization: 

— r'Theta data is [low, high ] 

=^Phi data is [low, high] 
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The user is then asked to supply the following limits in dB for the magnitude 
and the step size of the desired plot: 


-Enter minimum: 
-Enter maximum: 


-40 


10 


> Enter step size: |jy 


The final option allows the user to add comments to the hardcopy output. 


-Add comments ? 


n] ; 


y return 


If exercised, this feature allows the user to enter two comment lines of up to 
50 characters each to the plot page. If more than 50 characters are typed 
on either line, the extra characters are discarded and will not show up in 
the output comment field. To guide the user, a rule is printed before each 
comment line to be entered. A marks every tenth column. 

When Option 6_3 or 6_4 has finished accepting user input it writes a file 
in the present working directory ( pwd ) called harp.plot. This file contains 
standard unixplot statements and can be used with any of the standard 
drivers capable of interpreting unixplot commands. One important caveat 
here is that there can only be a single harp.plot file in a given directory at 
one time regardless of the number of family data files that may exist there. 
Each time Option 6_3 or 6_4 is invoked this file is over-written. 

There are any number of ways to convert the harp.plot to useful output 
manually. Outside HARP at the command line the following could be typed 
to manually create a postscript file assuming the plotSps driver exists on your 
system: 


$ cat harp.plot | plot2ps > newplot.ps 

This new file could then be printed in the usual way on any postscript printer. 

A far better way to get hardcopy output, automatically, is to let UNIX 
do the work by setting a shell environment variable and simply piping the 
output to a postscript printer. The environment variable used by HARP for 
hardcopy output is HARP.PLOT. Note that this variable must be set before 
HARP is started and cannot be reset from inside HARP using Option 3.3. 
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This variable can be set manually before invoking HARP, as will be shown 
here, or set permanently in the ,bash_login or .bashrc files. This is, of course, 
assuming that bash is the user’s shell. Just what HARP_PLOT should be set 
to depends on what is desired. Let us assume that no permanent file is de- 
sired, but that all graphic output should go directly to the default postscript 
printer. One would then simply type the following at the command line be- 
fore starting HARP: 

$ export HARP_PLOT=”plot2ps | lpr” 

Then the unixplot output from Options 6_3 and 6_4 will automatically be 
converted to postscript and sent to the printer. All manner of combinations 
are possible. For instance, if it was desired to save the postscript output to a 
file as well as have it go directly go to the printer, the following could be used: 

$ export HARP_PL0T=”plot2ps > newplot.ps ; lpr newplot.ps” 

In this case Option 6_3 or 6_4 would create a postscript file called newplot.ps 
and then automatically print this file. The caveat, like that for the harp. plot 
file, is that there can only be one designated output file in a given directory. 
This file would be over-written each time Option 6_3 or 6_4 is invoked. Of 
course, all the different plots would be printed. 

As a third example of using the HARP_PLOT environment variable to achieve 
a custom result, consider the situation where the postscript printer is in an- 
other office or building. In this situation it might be desirable to see what 
the printer output would be like on the screen. This is possible in a number 
of different ways, but one of the easiest is to set the environment variable 
before HARP is started like this: 

$ export HARP_PL0T=”plot2ps | ghostview 

If the plot2ps and ghostview software is available on your system, setting 
HARP_PLOT equal to this string will cause HARP to display a copy of the 
normal printer output on the screen whenever Option 6_3 or 6_4 is invoked. 
The usual harp.plot file is also written to disk. To finish viewing the plot, se- 
lect the Quit option from the pull-down menu under File. If the full Tekscreen 
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is in use, the blue “TekGraphics” box should then be clicked once with the 
left mouse button. The user will then be returned to the usual HARP menu 
system. 

These are only a small sample of the possibilities for plot output built into 
HARP. Setting up printer queues and providing drivers, however, is beyond 
the scope of this work and will not be discussed here. 
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Complete Examples 


The preceding chapters have prepared the user to enter cross- sections, build 
a model from these cross-sections, add fins and rotor blades, and finally 
to make the field calculations. Perhaps the best instruction, however, is a 
good example. In this chapter a small helicopter (like that used by police 
departments) will be constructed and field patterns will be calculated using 
both the MM and UTD methods. By actually doing the examples provided 
here the user should become comfortable with HARP and be able to enter 
actual helicopter geometries that will produce reliable field patterns. 


8.1 Entering the Cross-Sections 

The cross-sections for our example helicopter are shown in Figure 8.1. In 
this example it is assumed that a new subdirectory called example has been 
created, but nothing else. HARP’s output to the screen will be marked with 
long arrows and the user response will be indicated in boxed italics . As- 
suming HARP is started in a new directory the following is output to the 
screen: 


►Welcome to the HARP program 
►Harp initializing, please be patient! 


►A family name has not been set in this dir ector y. 
►Please enter the new default family name: esl 
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►The level of family name conformation used in HARP 
>can now be set. The flexibility of the HARP system is 
> affected by the level set. Please take note. 

> Enter a 1 for Expert level with maximum confirmation 

>-or a 0 for Novice level with minimum confirmation [0]: [return 


Next the default units menu will automatically be called because no default 
units have yet been set in this directory: 

=> Default Units 

=>< 1 > You want to work in meters. 

— > < 2 > You want to work in centimeters. 

=>< 3 > You want to work in feet. 

— > < 4 > You want to work in inches. 


Enter option. ..[!]: [ return 


Having hit | return | in this case, meters are automatically selected as the 
default unit for distance. The user is then placed in the HARP Main 
Menu where Option M_1 should be selected, i.e., Option 1 from the Main 
Menu. This action places the user in Menu [1] of the HARP system, the 
Geometry Entry Menu. Cross-sections can now be entered by invoking 
Option 11. There will be twelve cross-sections in all, but only seven will 
need to be entered on the tablet. How the others will be created will be 
demonstrated in Section 8.2. The seven cross-sections will be entered by 
digitizing the curves provided in Figure 8.1. For best results these curves 
should be entered as accurately as possible with up to fifty points each. 
The total number of points entered is shown in the lower right side of the 
screen as they are entered. While the accuracy of the model is good with a 
relatively few points, best accuracy is achieved with thirty or forty points. 
The tendency to enter too few points should be avoided, especially in the 
smaller cross-sections. If the cross-sections entered on the tablet do not 
appear on the screen as those in Figure 8.1, do not hesitate to try again. 
HARP will allow a new file to be written with the satnc extension number, 
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1 .0 


cross- Y value 

section (meters) 0.5 

1 0.0076 

2 0.1 524 

3 0.2743 

4 0.3962 

5 0.7620 0.0 

6 1 .1 582 

7 1 .2500 

8 1 .371 6 

9 1 .5500 

10 1.6000 

11 1.6500 — 0.5 

1 2 3.81 00 


-1 .0 

0.0 0.5 1 .0 

Meters 

Figure 8.1: The cross-sections used to build the example esl helicopter. 
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but only after conformation to do so from the user. 

Each cross- section file must have a unique extension number. These num- 
bers need not be in any order, but it is usually a good idea for them to be 
in increasing value as the y coordinate value of the cross-section increases 
from the nose to the tail of the aircraft body. Twelve cross-sections could 
also be entered consecutively from 1 to 12, but experience has shown that 
it is usually good practice to skip one or two consecutive numbers between 
cross-section extensions so that additional cross-sections can be added be- 
tween those already entered should that prove desirable. Having provided 
this caveat, it can also be stated these extension numbers provided by the 
user are irrelevant to the internal operation of HARP. They could be com- 
pletely random and it would in no way impair the operations of HARP. The 
only requirement is that each be unique. Having stated the above, to keep 
this example simple, the cross-sections will consecutively numbered from 1 
to 12. The curves marked 1,2,3, 4, 5, 9, and 12 in Figure 8.1 will be digitized 
on the tablet. These numbers will also correspond to the extension numbers 
for the cross-section files. r , 

All 


this 


m- 


The user input in this example, as usual, is shown like 
formation needed to enter the cross-sections is shown in Figure 8.1. Upon 
invocation of Option 1_1 the user will see the following where it is assumed 
that the user has hit 1 retum\ after each input shown: 


►Now enter the model description line. 


>>>: 


Section one , nose 


==*► Enter the cross section file number (extension)... [ 7 ] 


Enter the y-station location for cross-section 001 in meters: | .0076 


>. Is this a symmetric cross-section [Y] ? 1 return 


— ^Ent-r two points to use as a known distance on the tablet 

In Figure 8.1 this could be known distance such as 0.0 and 1.0 on the hori- 
zontal axis or -1.0 and 1.0 on the vertical axis. We choose the former here. 


► Enter this distance in meters: 1 10 


(►Enter the cross-section origin on the tablet. 
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Note that all the cross-sections must have a common origin even though each 
cross-section may not encircle this point. The origin used in this example is 
located at the point (0.0, 0.0) in Figure 8.1. While it is generally desirable to 
have this origin close to the centroid of the cross-sections, any consistently 
used point will work. This is a key point to remember when cross-sections 
are entered from different pages of an aircraft blueprint. All cross-sections 
must have a common origin. Continuing with the example: 

=> Enter any reference on the positive (up) z-axis 

This fixes the coordinate system for the tablet. 

=>■ Enter the half cross-section now starting on the + z-axis 
=S>Progressing clockwise, stopping on the - z-axis, 

=> Enter 6 to 50 POINTS, use BLUE to enter the last point. 

=>■( Use GREEN to delete previously entered points. ) 

Again, it is recommended that 30 or 40 points be entered. If the entered 
cross-section does not look like Figure 8.1, enter it again. Remember that 
the overall model can be no better that the cross-sections from which it is 
built. HARP always asks if more cross-sections are to be entered after each 
is completed. 

=$>Do you wish to enter another cross-section? [Y] | return 

The foregoing procedure is repeated exactly for curves 2, 3, 4, 5, 9, and 12. Do 
not continue with this example until these cross-section curves have been 
entered and look like those in Figure 8.1. 


8.2 Building the Master File 

Assuming the seven cross-sections were properly entered as described in Sec- 
tion 8.1, additional cross-sections can now be created and a master file can 
be built. This is accomplished with Option 1_2. The first operation to be 
performed is the creation of new cross-sections from those already entered. 
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Notice in Figure 8.1 that cross-sections 9,10, and 11 are identical, except for 
their y- values. Similarly, 2 and 8, 3 and 7, and 4 and 6 are the same except 
for their y-values. The c-opy operation provides a quick method to create 
new cross-section files by copying the data from one file to a new one. A 
different y- value can then be specified for the new file. Note that these new 
cross-sections could be entered just like the first seven, however, Option 1_2 
is easier and more accurate. Not only will the c-opy operation save time, but 
experience has shown that a better, more predictable model results from its 
use. Invoking Option 1_2 brings up the following choices: 


1-ist, b-uild, c-opy, y-location, i-nfo, n- ame, d-elete, r-edraw, e-xit: 


>• Enter your choice now [L-ist] : | return 


Selecting the default by hitting | return] will list the cross-section files created 
in Section 8.1. Assuming the seven files are present, the new files can be cre- 
ated. Cross-sections files 10 and 11 can be created from 9 and the y- value 
data in Figure 8.1: 


►1-ist, b-uild, c-opy, y-location, i-nfo, n-am e, 


► Enter your choice now [L-ist]: [ c return 


d-elete, r-edraw, e-xit: 


►What is the extension 
►that you want to copy 


number of the cross-section file 
? [none]: [p] 


►What is the extension number of the new cross-section 
►file that you want to create? [none]: 


10 


►The current preferred distance unit: meters 
►The original y value : 1.5 50000 


►Enter new y value : L600 


In an identical manner the file for cross-section 11 could be created from 
the file for 9 or the new file for 10. Do that now. Copy 10 to 11, 2 to 8, 3 
to 7, and, finally 4 to 6, being sure to pick the correct y-values from Figure 
8.1 for these new files. When finished, list the files again. There should be 
twelve of them. Pay particular attention to the y-locations listed for each 
file. They should be identical to the y-values listed in Figure 8.1. Make all 
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necessary corrections before proceeding. 

The master file can now be created by selecting b-uild: 

1-ist, b-uild, c-opy, y-location, i-nfo, n-am e, d-elete, r-edraw, e-xit: 


►Enter your choice now [L-ist]: b return 


►There are 12 cross-section files. 


=>-Do you want to exclude any cross-sections from the master? [n] return 
=>File esl. master was written. 

This completes the operations necessary to build the physical model of the 
body of the aircraft. 


8.3 Adding Fins, an Antenna, and a Rotor 

To complete the example esl helicopter, fins, rotor blades and an antenna 
must be added. From the HARP Main Menu, Option M_4 is selected. 
This places the user in Menu [4], the Model Comparison Menu. To add 
these new features to our model, Option 4_1 is invoked. When the Fin Con- 
trol Menu appears in the screen, select Option 2: 

=>File esl. fins does NOT exist. 

=> Enter fins now [Y] ? | return 

The fin design shown in Figure 8.2 can now be digitized on the tablet: 

=>0n the tablet, enter two points a known distance apart. 

For these points use the tips of the double ended arrow that is labeled 0.6 
meters. 


=> Enter this distance in meters: 0.5 


►Enter the leading attachment point 


on the tablet. 
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This is the point marked with “circle” arrow 1, Next digitize the second, 
third, and fourth points as HARP requests them by lining up the crosshairs 
of the digitizing puck over these points and depressing the YELLOW button. 


-Enter fin leading Y value in meters: | 3.5 


This information comes from the caption for Figure 8.2. 


=^Fin attachment angle from +x-axis around body (degrees): 40 


-Fin inclination from -f x-axis (degrees): \40 


-Enter the fin description tag now: | port side tail 
-Enter more fins [Y] ? 


return 


>Do you wish to reuse (copy/mirror) the fin planform [N]? y return 


-Enter either 1 for copy or 2 for mirror [2=mirror] return 


-Enter more fins [Y] ? n return 


Next comes the Antenna Menu where [jT] should be selected for a new 
antenna. 


-Enter antenna y value in meters: 


2.7 


=> Attachment angle from +x-axis around body (degrees): | 90 


This will place the antenna on the tail boom of the helicopter. 
=>Enter antenna length in meters: 

This is a quarter wave at 200 MHz. 


0.375 
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=>Enter angle with + x-axis (phi) : | PO 

This means that the projection of the antenna in the xy-plane would be 
pointing straight back to the tail. 

Enter angle with + z-axis (theta) : | 

Here the projection of the antenna in the yz-plane would show the antenna 
tilting back 20 degrees from the vertical. 

=>-Do you wish to save the antenna data to a file? [Y] | return 

After finishing the specification for the antenna, the Rotor Blade Menu 
is presented. Selecting [ 2 ] from this menu initiates the procedure for speci- 
fying the rotor blade assembly. The data for the rotor assembly is provided 
in drawing and caption in Figure 8.3. 


►On the tablet, enter two points a known distance apart. 


The tips of the 2.5 meter double ended arrow in Figure 8.3 should be entered 
for these points. 


►Enter this distance in meters: 


2.5 


Now enter each of the six points, in order, marked by the “circle” arrows in 
Figure 8.3. Be sure to use the BLUE button on the puck to specify the last 
point. 


►Enter the number of blades on the rotor: [~5] 


=>• Enter the y-location for the rotor in meters: 1 1 . 2 \ 
=>Enter angle with the + x-axis (phi): 


90 


=S> Enter the height of the rotor in meters: 0.24 


► Do you wish to save the blade data to a file? [Y] 1 return 


The example helicopter should now be displayed on the screen. The various 


HARP User’s Guide 


84 




CHAPTER 8. COMPLETE EXAMPLES 


dials on the dial box can be used to manipulate the helicopter in 3D so that 
all aspects of the model can be inspected for correctness. The capabilities of 
the dial box and certain function keys are fully explored in Appendix A. 


8.4 Building the MM Model 

To build the MM model, Option 4_2 is invoked. In this case the fields will be 
calculated for 200 MHz using the default responses to all questions except 
the last one concerning the attachment mode. 

=> Enter the desired angle of the first blade 


with the positive x-axis (in degrees) [0.0]: [ return 


> Enter the desired fore-aft tilt (in degrees) [0.0] | return 


> Enter 6 to 16 body sides [10]: return 


> Enter frequency (MHz): | 200^ 


► Enter segmentation size in lambdas between cross-sections [0.2]: return 


►Enter the attachment radius in meters ( 0 = none ) [ 0.2817 ]: 0 return 


By selecting [o], no attachment mode will be used. The MM model will then 
be calculated and displayed on the screen. As always, the dial box can be 
used to manipulate the model for complete inspection in 3D. 


8.5 Making the MM Calculations 

To calculate the field patterns for the model just created, from the HARP 
Main Menu, select Option M_5 to get to the Field Calculation Menu. 
From this menu there are two options to handle MM calculations. Option 5_1 
does not perform field calculations. It is used to verify the MM model actually 
used to make the field calculations by creating a new model from the output 
created by Option 4_2. Note that this is distinct from the graphical display 
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3 


4 


Figure 8.2: The fin design for the esl helicopter. The leading y-location 
for the fin is 3.5 meters, the attachment angle is 40 degrees, and the fin 
inclination with the +x-axis is also 40 degrees. 
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2.5 meters 



Figure 8.3: The rotor blade design for the esl helicopter. The y-location for 
the rotor is 1.2 meters, the angle with the +x-axis is 90 degrees, and the 
height of the rotor is 0.24 meters. 

created by Option 4_2. To view this model for correctness, Options 4_3 and 
4 4 a re used. To do the field calculations for the example esl helicopter invoke 
Option 5_2 at this time and take the default responses for each question. 
These calculations will take a few minutes to complete. Option 3_5 can be 
used to check the progress of the run. After the run has completed, Option 
6_3 can be used for hardcopy output. See Section 8.8 for details. The output 
should appear like that in Figure 8.4. 

8.6 Building the UTD Model 

From the HARP Main Menu select Option M_4- Then from the Model 
Comparison Menu select Option 4_5 to calculate the UTD ellipsoid. Be- 
fore calculating this ellipsoid, however, a new antenna needs to be selected. 
Warning! This antenna must be < ^A. Thus the antenna specified for the 
low frequency MM calculations cannot be used. Invoke Option 4_1 and spec- 
ify a new antenna in the same way as shown in Section 8.4 with the following 
data. Be sure to take the defaults for the fins and rotor blades. Warning! At 
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the present time, the plates generated with Option 4_1 are not incorporated 
into the input data for the NEWAIR code. Work is currently in progress to 
add this capability to the HARP code. 


> Enter antenna y value in meters: | ~LS\ 

>• Attachment angle from +x-axis around body (degrees): | 90 
(►Enter antenna length in meters: 0. | 


► Enter angle with -f x-axis (phi): | 90 


>Enter angle with + z-axis (theta): | 2d 


The above two angles should be entered; however, the NEWAIR code 
does not use them because it is assumed that the antenna is directed normal 
to the surface. 

=4>Do you wish to save the antenna data to a file? [Y] | return 


Now Option 4_5 can be invoked to calculate the UTD ellipsoid. 


► Enter frequency (Mhz): 2000 


Now select [J], the non-rotated ellipse option from the Methods for the 
X-Z ellip se menu . The default should be accepted for all other questions 
by hitting 1 return ) . The resulting ellipsoid can be viewed by invoking Option 
4_6 where it is displayed with the physical body it represents. 


8.7 Making the UTD Calculations 

Now the UTD calculations can be made using Option 5_3. 

=^The plate data file esl. plates does not exist... 

==> Continue anyway ? [Y] : | return 
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==> Frequency: 2000.000 MHz 
Available Pattern Cuts: 


==*1.) Theta fixed (az-cut) 
=*2.) Phi fixed (el-cut) 
=>3.) Abort run 


>-Enter choice now [1]: I return 
r Enter theta fixed angle now (in degrees) |90.0]: \ retur n 


The UTD code will then run to completion in the foreground almost imme- 
dfoteljc This is unlike the MM code which is launched m the background 
because it can take minutes or hours to complete^ The hardcopy P 
described next should appear like that in Figure 8.5. 


8.8 Field Plots and Hardcopy Output 

Select Option M 6 from the HARP Main Menu for the Field display 
Menu. Option 6 _ _1 will display the field patterns calculated by the MM cod 
on the screen while Option 6_2 will display those calculated by the UTD 
code. To get hardcopy, output Options 6_3 and 6_4 are use . 

that a postscript printer has been set up as your e a aU before HARP 

sume that the following environment variable was export / 

was invoked: 

$ export HARP_PLOT=”plot2ps | lpr” 

Now plots will automatically be queued to your postscript printer 
"ion 6 3 or 6.4 is invoked. The HARP hardcopy output should look l.ke 

in Figures 8.4 and 8.5. 
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HARP 

Helicopter Antenna Radiation Prediction 


Freq: 200.00 MHz 


MM computation in AMC 
Comments : Low frequency patterns for the esl helicopter. 


Antenna Data: 

Type: Monopole 
Length: 0.375 m 

User's placement: 
y = 2.70 m @ 90.0 deg. 
0: 90.0, <t: 20.0 deg. 

Base: (0.00,2.70,0.04) m 
Top: (0.00,2.83,0.39) m 

Pattern Data: 

Azimuth plane pattern 
© fixed at 90.0 deg. 



Node: tesla 
Sysname: tesla, 3.2e 
Machine: XD88/30 


Plot number: 712620844 
Friday Jul 31, 06:14 PM 


Figure 8.4: The MM hardcopy output for the example in the text. 
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HARP 

Helicopter Antenna Radiation Prediction 

Family name: esl Freq: 2000.00 MHz 

UTD computation in NEWAIR 
Comments: High frequency patterns for the esl helicopter. 


Antenna Data: 

Type: Monopole 
Length: 0.030 m 

User’s placement: 
y - 1.30 m @ 90.0 deg. 
0: 90.0, <D: 20.0 deg. 

Base: (0.00,1.30,0.55) m 
Top: (0.00,1.31,0.57) m 

Pattern Data: 

Azimuth plane pattern 
0 fixed at 90.0 deg. 



Azimuth Angle O (Degrees) 


Node: tesla 

Sysname: tesla, 3.2e Plot number: 712965296 

Machine: XD88/30 Tuesday Aug 04, 05:54 PM 


Figure 8.5: The UTD hardcopy output for the example in the text. 
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Dial Box and Function Keys 


HARP is designed to operate efficiently with a dial box, and it is assumed 
that your workstation is equipped with such a device. The Tektronix dial box 
is a gray box with eight knobs and two liquid crystal display (LCD) panels. 
This box is interfaced to the XD88 workstation’s graphics system, and is 
used to manipulate the various 3D images created by HARP. The user has 
the flexibility to inspect the models by rotating, translating, and zooming in 
on any interesting aspect of the model. The function of each knob is labeled 
just above it on the LCD screen. The function of the dial box varies slightly 
from Option to Option. For each Option in HARP that uses the dial box, a 
complete description is provided in this chapter of the functions provided. 

The keyboard of the Tektronix XD88 has several function keys. These 
keys, marked FI through F8 plus the “Help” key, have been programmed 
to provided additional functionality and flexibility to the HARP user. The 
operation of these function keys is also described in this chapter. When 
functions are active, their operation is summarized by a legend at the bottom 
of the screen (unless they have been toggled off with the Help key). 

Each of the Options that use these capabilities will be described here with 
the convention that D5, for example, will mean dial box knob number 5. The 
function keys will be specified similarly. All Options that that are capable of 
displaying 3D graphics have the same functions programmed into the same 
dial box knobs. Options 4_1, 4_2, 4_5, 5_1, 6_1, and 6_2 all have the same dial 
box function for the same knobs. These functions are as follows: 

D1 translates the aircraft model along the HARP x-axis. 
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D2 translates the aircraft model along the HARP y-axis. 

D3 translates the aircraft model along the HARP z-axis. 

D4 has no currently programmed function. 

D5 sets the roll plane of the aircraft model. Adjusting this knob rolls the 
model in place. 

D6 sets the pitch plane of the aircraft model. Adjusting this knob rotates 
the model in place, end over end. 

D7 sets the yaw plane of the aircraft model. Adjusting this knob turns the 
model to port or starboard about its midpoint. 

D8 is the zoom control which essentially adjusts the magnification of the 
image on the screen. 

For Option 4_1 the following function keys have been programmed: 

Fl rotates the main rotor blades for helicopter models. 

F2 toggles the main rotor blades on and off. 

F3 toggles between top and side views of the aircraft model 

F4 places the model in the standard position and attitude it had when it 
was first drawn on the screen. 

Help toggles the key labels at the bottom of the screen on and off. 

For Options 4_2, and 5_1 the following function keys have been programmed: 

F3 toggles between top and side views of the aircraft model 

F4 places the model in the standard position and attitude it had when it 
was first drawn on the screen. 

Help toggles the key labels at the bottom of the screen on and off. 

Option 4_5 has the most function keys programmed: 
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FI toggles the translucency of the aircraft body on and off so that its close- 
ness of fit with the UTD ellipsoid can be more easily ascertained. 

F2 toggles the graphical segment highlighting on and off. This feature en- 
hances the appearance of the model when it is on and allows for more 
rapid movement of the model with the dials when it is off. 

F3 toggles between top and side views of the aircraft model 

F4 places the model in the standard position and attitude it had when it 
was first drawn on the screen. 

F5 toggles the rotor blades on and off 

F6 toggles the body of the aircraft model on and off. 

F7 toggles the UTD ellipsoid on and off. 

F8 toggles auxiliary plates used in the UTD code on and off. 

Help toggles the key labels at the bottom of the screen on and off. 

Options 6_1 and 6_2 have the following function keys programmed: 

FI toggles between displaying the 9 and <f> polarizations. 

F4 places the model in the standard position and attitude it has when it is 
first drawn on the screen. 


Help toggles the key labels at the bottom of the screen on and off. 


Function keys and dials that have not been programmed have no effect on 
the operation of HARP. The function keys that have been programmed are 
always labeled at the bottom of the screen. The dial box knobs that have been 
programmed are always labeled in the LCD screen above the knobs. While 
not exactly function keys, there are two other functions that are initiated at 
the menus by typing designated characters. At the HARP Main Menu 


entering v return will display the HARP version number and other data. At 


any HARP menu the graphics images can be cleared by entering | c return 
HARP is not case sensitive to these inputs. 
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The HARP Executable Images 


Each of the menu options in HARP is tied to one or more executable images 
that are located in $HARP_BIN. In the following list the Option number is 
followed by the name(s) of the executable image(s) tied to it in boldface. 

1_1 enter_xct enters body cross-sections. 

1_2 build_master builds/modifies the master file. 

1_3 silhouette shows 2D silhouettes of the fuselage. 

1_4 pre_viper, viper makes new cross-section files by interpolating two 
original cross-section files. 

3_1 set_cfn sets family name and preferred distance units. 

3_2 set_units sets user’s preferred units for distance. 

3_3 harp_shell temporarily exits HARP to user’s shell. 

3_4 bug_report sends a bug report via email to Ohio State. 

3_5 predict predicts completion times for MM calculations. 

3_6 noah archives/recovers data files for a given family name. 

3_7 harp_status writes a summary sheet of HARP data. 

3_8 write_amc_defaults sets temporary AMC defaults. 
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41 erb makes the fuselage model and allows addition of fins, antennas, and 
a rotor. 

4 2 mrb makes the AMC input file and displays its geometry. 

4 3 find_ellipse calculates NEWAIR ellipsoid parameters. 

4 4 gtd_platemaker calculates NEWAIR plates. 

4 5 gtd_model shows the complete NEWAIR model. 

4 6 towelbar provides the user with a graphical way to enter a “towelbar” 

antenna to be used by the AMC code. 

51 amc_preprocess, amc, modes, geom shows the AMC output model. 

5 2 amc preprocess, amc makes the MM calculation with AMC. 

5 3 newair_manager, newair.preprocess, air7, newair_postprocess 

makes the UTD calculation with NEWAIR. 

6 1 insitu shows the AMC (MM) results on the screen. 

6 2 insitu shows the NEWAIR (UTD) results on the screen. 

6 3 harp.unixplot prepares hardcopy output of AMC (MM) results. 

6 4 harp.unixplot prepares hardcopy output of NEWAIR (UTD) results. 

You will notice that a number of different menu options call the same ex- 
ecutable image or images. What makes these options different is that each 
uses a different internally generated command line argument. For instance, 
Options 5 1 and 5_2 both call amc_preprocess, but Option 5_1 uses pre-run as 
an argument while Option 5_2 uses full-run. After preprocessing, amc is in- 
ternally called to do the appropriate calculations. Similarly, Options 6_2 and 
6 3 both call insitu with arguments .amcjplot and . newair_plot , respectively. 
" Choosing Option 5 3 to do the UTD calculations actually invokes four 
separate executable images. Newair manager calls newair_preprocess to pre- 
pare an input file and then calls air7 to actually do the calculations. Finally 
newair jostprocess is invoked to translate the output into HARP coordinates. 
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Data Files Used by the HARP 
System 

The data used by HARP is kept in a number of different files. Three of these 
files, CFN, UNITS, harp.plot, and AMCtemp.defaults are common to all 
family names in a given directory. The rest of the files are always specific to 

a family name. Assuming a family name of /em esl, the following files could 
exist: 

• AMC_temp_defaults is a temporary file that should exist only if 
Option 3_8 is used to set new defaults for the AMC code. This file is 

only used in Option 5_2 where it modifies the standard defaults for the 
MM code. 

• CFN contains data on the current family name and expert level. It is 
used by all HARP codes to automatically pick up the family name. 

• UNITS contains flags for the current default unit for distance. 

• esl. 001 - esl. 01 2 are the cross-section data files created by Option 1 1. 

• esl.amccurrents contains the amplitudes of the current modes calcu- 
lated by the AMC MM code. This file is not currently used by HARP. 

• esl.amc_errors contains all the warnings and errors generated by the 
AMC MM code. In rare circumstances the MM code may run to com- 
pletion, but yield strange results. Clues to the possible reason for these 
results may be contained in this file. 
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• esl.amc_fullrun is the input file used for complete MM field calcula- 
tions. 

• esl.amc^geom is the output file generated by the AMC MM code that 
contains geometry information about the model. It is this file that is 
displayed by Options 4_3 and 4_4. 

• esI.amc_output is the general output file for the MM code and con- 
tains a wealth of information about modes, cross-sections, sources, and 

more. 

• esl.amc_plot contains the electromagnetic field data calculated by the 

AMC MM code. 

• esl.am C _pre r un is the input file for the AMC MM code used when 
only the geometry is to be verified. 

• esl.amc_status contains status information on the progress of the MM 
field calculations in AMC. This file is used by Option 3_5 to predict the 
completion time for the current field calculations. 

• esl.ant contains data completely describing the current antenna. 

• esl.ellip contains data specifying the composite ellipsoid used by the 
UTD code NEWAIR3. 

• esl.fins contains all the control fin data for the aircraft model. 

• esl. master contains a list of all the current cross-section files along 
with their y coordinate values used for the current physical model of 
the aircraft. This file is generated by Option 1_2. 

• esl.newair_aux contains data used in creating the UTD NEWAIR3 
code input file. 

• esl.newair_errors contains error statements generated by the opera- 
tion of the UTD NEWAIR3 code. 

• esl.newair_in is the input file for the UTD NEWAIR3 code. 
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• esl.newairjog contains key data logged by the UTD code NEWAIR3 
as it runs. 

• esl.newair_out is the NEWAIR3 code’s binary output file. It is not 
readable by the user. 

• esI.newair_plot contains the electromagnetic field data calculated bv 
the UTD code NEWAIR3. 

• esl.phys_body contains graphics data for the aircraft model body gen- 
erated by and used by Option 4_1 as well as others. This data is gener- 
ated each time Option 4_1 is invoked after a new master file has been 
created by Option 1_2. Thereafter, time is saved by reading this file 
instead of recalculating the data. 

• esl. rotor contains all the rotor blade data for the model. 

• esl.towelbar contains all the towelbar antenna data for the model. 

• harp. plot is the unixplot output file used for hardcopy output. 

All of these files except esl.newair_out and harp.plot can be viewed with 
your editor or echoed to the screen with UNIX pg or cat commands. 
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HARP Directory Tree 


The binaries and source files that make up HARP are located in specific di- 
rectories which group certain functions together. The top Rectory, ^denoted 
$HARP_CODES here, is the site-specific directory where HARP has been 
installed. All sub-directories of this directory are identical to those listed be- 
low at all sites. This complete HARP directory tree and the general function 
of the code in each of these sub-directories is listed below: 


$HARP_CODES • • • main site HARP directory 
| amc_code • • • sources for MM executable 

| predict • • • predictor for MM completion 
| bin • • • all HARP executable binaries 
| body_code • • • 3D fuselage and attachments 
| gtd_body • • • 3D UTD model 
| tbar • • • towel bar antenna for MM code 
| file_io • • • major HARP io system 

| archiver • • • file storage and recovery 
| gtd_code • • • contains only sub-directories 
| ellipse_code • • • UTD ellipse generator 
| exe_code • • • sources for UTD executable 
| plate_code • • • UTD plate generator 
| prep_code • • • UTD input file generator 
| lib • • • location of HARP libraries 

| srcs • • • sources for the HARP libraries 
| menus • • ■ main menu system 
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| mode_geo • • • MM 3D model 
I pIot_code • • • screen plot 

| hardcopy • • • paper output 
| x_sect • • • fuselage cross-section entry 
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